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Preface 


The complete XENIX Reference Manual is actually divided into six parts 
and distributed as individual reference sections in the various volumes of 
the XENIX Operating, Text Processing, and Development Systems. The 
following table lists the name, content, and location of each reference 
section. 


Section Description Volume 

C Commands — used with the XENIX User’s Reference 
XENIX Operating System. 

CT Text Processing XENIX Text Processing Guide 
Commands — used with the 
Text Processing System. 

CP Programming Commands XENIX Programmer’s Reference 
= used with the 
Development System. 

M Miscellaneous - infor- XENIX User’s Reference 


mation used for access to 
devices, system main- 
tenance, and communi-— 
cations. Hardware specifc 
manual pages are located at 
the end of the Run Time 
Environment volume. 


S System Calls and Library XENIX Programmer’s Reference 
Routines — available for C 
and assembly language 
programming. 


F File Formats — description | XENIX User’s Reference 
of various system files not 
defined in section M. 


In text, a given command, routine, or file is referred to by name and 
section. For example, the programming command “cc”, which is 
described in the Programming Commands (CP) section, is listed as cc (CP) 
in the text. 


The alphabetized table of contents given on the following pages is a 
complete listing of all XENIX commands, system calls, library routines, 
and file formats. If you want to locate information about a specific item 
look in the indicated reference section. 


Alphabetized List 


Commands, Systems Calls, Library Routines and File Formats 


ROE eS aes a.out(F) DOME sAisci esa ei sn ssas bdiff(C) 
| SATS ee AEN ao4l(S) hessel © ...iosicesccceeses. bessel(S) 
BIE cor easeeeecricssats abort(S) BES clades esravesks bfs(C) 
BEG. Seed ere abs(S) DOOE oc Abcssssaesceavas boot (M) 
BOCESE —S. Goada ii vesccaass access(S) BE doce ccoetaacssecaaandaa: sbrk(S) 
BOCEe es acct(F) DSOArOR: bsicies cscs bsearch(S) 
dg Sie et SOR ee OD acct(S) Cabs: Ali Macias hypot(S) 
BECODE cic secd iSacaiaae accept(C) CA) dsc ccte Aassdossesieeaes cal(C) 
BECICOMD. 6.56 iicaes: acctcom(C) calendar ............ calendar(C) 
BOMION inset accton(C) CANOC fidsccsseeccrees. malloc(S) 
BCOS oir aes trig(S) CORO iis cc ave Ip(C) 
Lae, Sobek Ne rete adb(CP) CSb ec eerie cat(C) 
RNG silat admin (CP) PD Scctiencss eee cb(CP) 
ee br Ree eee alarm(S) "OPE Te OR ReEeeT ere cc (CP) 
BUGGER ecicneyssccesees aliases (M) CO ccihicsetenceree cae cd(C) 
aliases.hash ......... aliases (M) O06 shinee vines cdc (CP) 
aliashash ......... aliashash (M) COM icc igviascncccsaxens floor(S) 
tee Rol BY ME ee OP rE TS ar(CP) CHOW) coos ccdearssvvveves cflow(CP) 
BE sce becl is eed xTl ona pncns ar (F) CHOI SE iwisviceesss chdir(S) 
mee a Peeve a asx (CP) Checkewel. iitiicsssssess cw(CT) 
BOO a ha uaciae ascii(M) checkmm ....... checkmm(CT) 
POC Siac ase ctime(S) checkeq ........c.sc.008 eqn(CT) 
ay gih ihe se OR eR eee reer trig (S) checklist ............ checklist (F) 
eee rete prea asktime (C) CRO esis SS recsieteescis chgerp(C) 
PESO Sa vcwcisseasesvees assert(S) chime iirc. chmod (C) 
BOGS eas taceecv eves assign(C) CHMNBE iis chmod (S) 
ee RR AS RO PUNE EPO AA at(C) dh | a re chown(C) 
Ree rT Soe eee trig(S) CHOW A. Aiiescscen chown(S) 
BR ee pucssxevstersaiyr es trig(S) CHOOSE ©. ie. csiveeesses chroot(C) 
COE Sea seccisuosacuuane strtod(S) Chrepe oh ieccisscnas: chroot(S) 
BUGE ova siventi meres: atof(S) CHES sida iaiaevcnsees chsize(S) 
dt Ge ORD Pe Laem D atof(S) ds eee eee ferror(S) 
BE Ee vies ccnnineeees strtol(S) CHIT ee Since das clock (M) 
Be Oe iciereaem atof(S) CWIOK Airis eeahsins clock (S) 
BEBE Ae ee seeaese strtol(S) clockrate .......... clockrate(C) 
autoboot .......... autoboot (M) CUIGE wired eiad caters close(S) 
a eae aay a RRR eY awk (C) closedir 1.22012... directory (S) 
BACHE. 6.5 -<cciese se backup(C) CL pccclei Reese cevesss clri(C) 
backup ............... backup (F) CIUICRG + 35.5050 sccensae’ cmchk(C) 
badblkutil ....... badblkutil(M) CRD 6 cg Bia tes ovsactt vere: cmp(C) 
ae ener badtrk (M) COBB. Boies ceetaciecess cmos(M) 
DOBHEE= .20+ + cs0ceccees. banner(C) CO) deceit ea ieont col(CT) 
basename ........ basename(C) COMD s.clblessiviaces'ss comb (CP) 
ts, | SOR aR ODER ERE ATES at(C) COMME 25 hess secersnecens comm(C) 


console .............. console (M) Se dircmp(C) 


CE ee ivanavesuvenesss conv(S) directory ........... directory (S) 
ee copy(C) dirname ............. dirname(C) 
re hie ATR a core(F) disable ................ disable(C) 
COR int iaceackscexs trig(S) GUSKCHID ........060005- diskcp(C) 
PUTT. ysis invsvonsigass sinh(S) "OO Ca a diskcp(C) 
NE Se aah unpy coreenenes cp(C) IVES eLadihersvcssissesyes divvy(C) 
ree cpio (C) IE is ciciicndideniens dmesg (C) 
od en ee aE? cpio (F) MG a ay iaRicas denskaxees dos(C) 
CH Ki ia iveidevecesisens cpp(CP) OE io oiikc voasskacveses dos(C) 
CRORE iiss cecssseaans creat(S) GORE diocsisncinccevaeeseee dos(C) 
creatsem ........... Creaisem (S) .... GOSOI€ ocrsccisscssctaseceess dos(C) 
Se ee ee cref(CP) GUM SS exkcetiawasenss dosld(CP) 
ISA yanh oi cas snaencanas cron(C) OBS Bois isis assssswcaears dos(C) 
CEM ed Faery ss cin ndasennans csh(C) dosmkdir ................. dos(C) 
COME atic deasspvcsesceas csplit(C) OSE scnscsuecsiavens dos(C) 
CRB a iviiiccscavses ctags(CP) OU i cdiccicsss eines dos(C) 
ee ctermid (S) drand48 ............. drand48(S) 
CEES ikgaiscsssieenes ctime(S) 1k (Se ee dtype(C) 
CRO rdiiccdecaveraesass ctype(S) Sy Sn eon eae du(C) 
i Rey RL ee ve Re Roe! cu(C) CRIN Fi sires cavs cceuceess dump(C) 
OUTROS iis divenncssv es curses(S) CTR Fo ido avs ssvcceadeves dump (F) 
cuserid ............6... cuserid (S) dumpdir ............ dumpdir(C) 
CUSTOM Sissies. . cesses custom(C) GU: Fitri iceiss saves dup(S 
We A hscitacicsnineres cut(CT) WANE: Fac iseccivasaxcnercsss dup(S) 
OUR reas ia phakincsceyouss: cw(CT) BOGE -sacncciiiiacdd vans xars 8087 (M) 
CWOROEN viecccvesensncsces' cw(CT OW os sve Niicvunuvnwededs 86rel(F) 
CHP Sok apr hitcesscees cxref(CP) BOW vrscccctcriaa resco: echo(C) 
daemon.mn .. daemon.mn(M) Coie ais Wacsevis'cs ecvt(S) 
re a, ee date(C) OEE eiiisG ve estadavaasecsinseen ed(C) 
dbminit -yissci.........060. dbm(S) Cres csicssh vices cacann end(S) 
RO aR SCRE Se, aoe ene ree dc(C) QPOs Sissiseccasssenuics grep(C) 
RSE So ene ee eee dd(C) ONBDNG v5ccckcesscvosces enable(C) 
deassign ............... assign (C) 1 ie ee end (S) 
GeTAGN < e2i2isioccsess default (M) endgrent ............. getgrent(S) 
defopen .............. defopen(S) endpwent ........... getpwent(S) 
defread ............... defopen(S) enduntent ............... getut(S) 
GION Fs So AZ ou cae acicieess dbm(S) UN NS ea ties bien se seaeinss env(C) 
CES sais cocessesnns delta (CP) ENVIFON ...........04. environ(M) 
deroff .............200. deroff (CT) EE Fo Nee senieouunies eqn(CT) 
BOVAAT | Gi eccccncivncas devnm(C) eqnchar ........... eqnchar (CT) 
Ee DANA Gis i sesneeetass df(C) eqncheck ............... eqn(CT) 
aks ikke sons ens dial(M) erand48 ............. drand48(S) 
| rr Serer oper rere dial(S) 5 RO Ok En BPE EN erf(S) 
diction .............. diction(CT) BET ns csc hsvnexs perror(S) 
aii ese evisvves diff (C) RE BE covnis taneer ates end(S) 
GUNS bP Saka re caso nsccons diff3(C) OR re andes ceva ex(C) 
diffmk ............... diffmk (CT) CRO Go casessgesvenines exec(S) 
Oe lei Rd weioes dir (F) COs exec(S) 


ROE iiss soiis Suess exec(S) iN So liecssscsies stat(S) 


ORBOI ccc isa sig cisstdcases exec(S) TO ete regs fseek(S) — 
CTO osSisicicicniniccseess exec(S) INS SoS Avacksnisiriaivics time(S) 
PRM ies cuescusereensnes exec (S) TG concocuugecseciawenvee stdipc(S) 
CUI ocisncesssseediexaxs exec(S) 1 Re Gn ran ane la tw(S) 
WEIR rockisicuncverebinssivers exit (S) SWIG os ikacasicsesscesces fread(S) 
Peek ds aces eiaaaas exp(S) PSO hic disiiiisstvends xlist(S) 
| re explain(CT) PAMMA .......ceeceeee gamma (S) 
COE ras iwckeiesdecanes expr(C) OVE sc cicecaiaapeardiodaucas ecvt(S) 
PAS baUieriticicaais floor(S) BOS casita iaoscacenaenes get(CP) 
GOES fcc ncnticmens factor(C) CONE ory xiicceressanevncteies getc(S) 
PRUNROR  ccsvceksssesans aliases (M) BOTTIOR dics ixs cansnseceseas getc(S) 
TI asi vse ice evn van andes false(C) PECCWEsiiisccncccsccnne getcwd (S) 
GOGO sosaicicctiniasicss fclose(S) COTO UI on cane nnceadcass getuid(S) 
oo ae Oe rere fentl(S) BOCCAY: asa ccicsscenasans getenv(S) 
NN ice iaiaisagreetasercn ecvt(S) SECC age esecncseiaess getuid(S) 
| ee ere en nee fd(M) PnP: a eae eee getuid(S) 
BM chs essces cee vanns fdisk(C) getgrent .............. getgrent(S) 
TROUT evista scnsexsaas fopen(S) getgrgid .............. getgrent(S) 
ET Gane pO ee ferror(S) getginam ............ getgrent(S) 
SEINE Soc dks ccedretevscors ferror(S) getlogin .............. getlogin(S) 
TRU isc Ricioiaticxes dbm(S) OT etree getopt(C) 
TS ctacnetcieeionszass fclose(S) ORI a ish obyesx acess getopt(S) 
WE cad as wh vein eanncn se getc(S) DOI ONG 5 asso scxcccees getpass(S) 
ON, OE ROT AERA gets(S) PEINBID: on cscssscseccencs getpid(S) 
POS oa siccn eae owasides grep(C) ROTI -ihidoesponavevess’ getpid(S) 
file system ....... file system(F) Pe ee ee getpid(S) 
TRS sgtvlenty curser avesnenkes file(C) BOUIN iii cccciesliakcxxes getpw(S) 
IRD icvsacke eas cseuetss ferror(S) getpwent ............ getpwent(S) 
Do eiinsaverntssdioiacnetes find (C) getpwnam .......... getpwent(S) 
RE COR ST CET finger (C) getpwuid ............ getpwent(S) 
GIOG odes issacdvsises dbm(S) COG ee ition gets(CP) 
CR iss asecacees fixhdr(C) BONE winced vise cidielis gets(S) 
QRETME ois didencnesss fixperm(M) CNIS ssc cctu eee cannsue' getty (M) 
TE fois coh iciaicasiaeeecss floor(S) gettydefs ............ gettydefs (F) 
Te iivsds hkisevorsiiioass floor(S) COWIE ih ccckycinaveess getuid(S) 
CRO Bosicccnskexccuneses fopen(S) SPT dics ckccceaveei tans getut(S) 
PIE siccss cia way sev nceenieses fork(S) POUMMNE cose c cee cessvnns getut(S) 
a a ere ee format(C) OMENS 5s caus av osncs iods getut(S) 
SIGE yi weds sutxxaeeines printf(S) POWMITINE vacincsccosscssves getut(S) 
VOM hips des xdhincundo ds putc(S) SRW rian Acedia cs sin gs 0060s getc(S) 
PEE i svdesvaccisestearenees puts(S) SMAI noises s0ssenaess ctime(S) 
PRE a ics acre snsaneenes fread (S) BPR dic vintesstvcclastsoat grep(C) 
WO her exwisncanntss malloc(S) CO on lees eck ceasees group(M) 
POROOOU: se ceixecjussexes fopen(S) grpcheck ........... grpcheck (C) 
ROI iis cesiveneiecesueees frexp(S) POMBE sccscavecxkecess ssignal(S) 
POOR is ces cvyecetetiees scanf(S) DOIG sic cictecnesseexe haltsys(C) 
POI ites sev iawieda tauen fsck(C) BE easitcsaeceicacaeuvceieestes hd(C) 


RN less cisscexdzesends head(C) 
BRE Sei. caiccasiisessin help(CP) 
HEPES Ss. 0. .ccee ses hsearch(S) 
hdestroy ............. hsearch(S) 
pr | | rr hsearch(S) 
hyphen ............. hyphen(CT) 
os a oe hypot(S) 
Beer ahs vaccines id(C 
oe. | a imprint(C) 
HE ccive'ssaevscxuan'c init(M) 
MNGGO Vy sceccnisevecccvees inode(F) 
E> ee install(M) 
ROH vc cecvevewcevees intro(C) 
ONS . vtapecatexeds intro (CP) 
NGF O sa veeweteven es intro (CT) 
a ee ere ree intro (F) 
Sg A a eee intro (M) 
aaah epee eee intro(S) 
MOE Ss Sie cides cocvvisees ioctl(S) 
Se | ie? 2 eee! ipcrm(C) 
es eee ee eee ee ipcs(C) 
isalnum ..............060. ctype(S) 
| i ra ners ctype(S) 
5 Lae Caer ers ctype(S) 
2 ttyname(S) 
er Be rere ctype(S) 
Oe ctype(S) 
oe) ctype(S) 
IS]OWED ..........0cceeeees ctype(S) 
SOMPUEEEN 2502 ds ic actaes cock ctype(S) 
ISPUNCE .....55..505c08500 ctype(S) 
ISSPACE .............cc eee ctype(S) 
re ctype(S) 
SSRN ioe cieeenicees ctype(S) 
FO iisecaviscassisinss bessel(S) 
GE Aes eseucctvenetes bessel(S) 
[RCE ioe bessel(S) 
POE ei acreeicictevesccnvs join(C) 
jrand48 .............. drand48(S) — 
keyboard ......... keyboard (M) 
Ree ee eee ere kill(C) 
AS ph OIRO EA kill(S) 
MME To Fah svcsee sien cves mem(M) 
Beer a Fis cers ebetaietes I(C) 
7 AAS AA Eee So ee 13tol(S) 
oc ERD eens ee a64l(S) 
AR a UR er CL peter Ic(C 
Icong48 .............. drand48(S) 
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SO: ie ae ld(CP) 
IRS Sl Sl oA Id (M) 
MAE 65 ee et frexp(S) 
is REE EC Te een ee lex (CP) 
ME Fere ch esebicecsal ares line(C) 
MB Cet thoi 0555700809 link (S) 
MONG ec otic vvevnieeses cect. lint(CP) 
i GM ay A ROME CT eet eRe EED In(C 
localtime ................ ctime(S) 
MOG ih Aee veers deveens lock (S) 
MOGRE OR ise emcpicccicdees lockf(S) 
LOCKING 555.60. 0550000. locking (S) 
MME Ay seciaasxesesccaseses exp(S) 
MONO isi cacidssseaveurterevs exp(S) 
NOE hi os sisscivesecees login(M) 
logname ............ logname(C) 
logname ............ logname(S) 
fo setjmp(S) 
MOI wii sa iacveas ies cde’ look(CT) 
MANION secon elt oeisas lorder(CP) 
ACTS DE EA aE Ip(C) 
eu cieis arisen eneiees Ip (M) 
Ipadmin ............. Ipadmin(C) 
IDI Hav ccteccceteestess [pinit(C) 
Ipmove ............... Ipsched(C) 
MOE Faas bebnisasshiaiecisoes Ip(C 
lrand48 .............. drand48(S) 
Ipsched ............... Ipsched(C) 
| [psched(C) 
Le | Sa aE RE Ipstat(C) 
ERE 5 SE RE DROID PDAS Is(C) 
eee ree lsearch(S) 
IGOR a ivesisssnvxccctees lseek (S) 
SS a aN Pe 13tol(S) 
WOO ee secrinstscdettheabionens m4(CP) 
machine ............ machine (M) 
pt ie sh eee eae mail(C) 
BIO ey ca cae sicscicasens make (CP) 
maliases .............. aliases (M) 
MIGUGO? Fo vccccecesses malloc(S) 
os See ee man(CT) 
mapkey .............. mapkey (M) 
mapscrm ............ mapkey (M) 
cD le Ce mapkey (M) 
i SANS I eR a masm (CP) 
Ut: ener See master (F) 
PRINCE cos seers matherr(S) 
I oo 2s es se mem(M) 
memccpy ............ memory (S) 


memenpp ............ memory (S) 
memcpy ............ memory (S) 
memset .............. memory (S) 
MeMOTY ...........66. memory (S) 
Sh ccs ca caasnaneuess mesg (C) 
messages ......... messages (M) 
WOT iisansencscxdais micnet(M) 
PAGE sicdscncsencessnircs mkdir (C) 
ANTE i cichacavesiceviaress mkfs(C) 
WAMOG Gs cccpseecsseeees mknod(C) 
TUTE 5 csancisssvxexes’ mknod (S) 
DARGIS co ciaiccisssraesce mkstr (CP) 
mktemp .............. mktemp(S) 
LO, ere mkuser(C) 
BAM ciewissccigenincacesess mm (CT) 
mmcheck ....... checkmm(CT) 
WAI ores cssccconeesrasins mmt(CT) 
SPEGREN iss ccasecstcees mnttab(F) 
WAGE ooo hc ivea sa vnccuascexes frexp(S) 
SHONILOT accssccssciees monitor (S) 
II airs cinc cscs cieuinnne more(C) 
IE 8 inn ciaecveness mount(C) 
DOUG vcsesnescecersaaes mount(S) 
mrand48 ............ drand48(S) 
WN RO i ceyiabssetiics msgctl(S) 
WME 5 sca cevn seuss sins msgeget(S) 
WO iss dackeedicekes msgop(S) 
multiscreen .... multiscreen(M) 
Wiican sp eckedetenseneies mv(C 
WRG aya aah acinccienreenes nap(S) 
nbwaitsem .......... waitsem(S) 
WENGON cocsiicisiassncsx ncheck(C) 
Me ccces is ceieuvicstis eqn(CT) 
EN ais iss ousccanes neqn(CT) 
POU, Senn sxivcisnvoncs netutil(C) 
newform ............ newform(C) 
NEWEIP ........ eee eeee newgrp(C) 
DWN iscsi cpdwissdewesvast news(C) 
TOMIRAY: iidcsiicscsvon ascents dbm(S) 
GR 2 icvatde'cannaiennciees nice (C) 
EOE Seen ai wieeseevdenvss dene nice(S) 
MY hah and eacentasateaaedes nl(C) 
BE cuncercatessaxensicese nlist(S) 
BR OS i ctevscvvdacveakes nm(CP) 
GONE his ciccesoeseese nohup(C) 
nrand48 ............. drand48(S) 
INIT ss sscccsicaase-can seen nroff (CT) 


SES icecay caswrsawnocenen null(M) 


O08 stecetacpmidiee od(C) 
OGTR sic cideawecctessene open(S) 
opendir ............. directory(S) 
opensem ............ opensem(S) 
WRK, Gaccacascsecswndass pack(C) 
WOESNEL socks scscsxs parallel(M) 
PASSWA ..........00008 passwd (C) 
DASSWA. ......00s0cee0: passwd (M) 
GREE iia epsee seen te paste(CT) 
WOUEE six, ceotuxniowavvers pause (S) 
Se, Sean a Tee Aver pack(C) 
DCIORG occcests cosesxcaes' popen(S) 
REPO zi cocaetacerenss perror(S) 
WAGE Say dcdsinndoad paenssvesawaes Pg (C) 
WE rs ince ccauenccnipe id pipe(S) 
BIDEN sncisnicasorrvecenve’ plock(S) 
PO Sos ixsncavieusevis popen(S) 
BOW Kc ccs ctveciennczene exp(S) 
DE cigdevicasailarsin eens pr(C) 
MI ash iri snc pan desee prep(CT) 
ee: ea ee printf(S) 
VOGEL siccincsicsac ccna: proctl(S) 
AE iste one coe oneiese's prof(CP) 
WININNE iicks coca bevaes caves profil(S) 
Pg ee ae profile (M) 
i ne ee eee prs(CP) 
reer cat acnseccisshewten ps(C 

RIAE si crecssesvecwessess pstat(C) 
WWE oss ccvexscsr vasves ptrace(S) 
WOO casei cen tyke oanrawve ptx(CT) 
LL ee TREO ee BRR re putc(S) 
PL | ee a ee ee putc(S) 
WARE ciaupexcacensadnrs putenv(S) 
putpwent ........... putpwent(S) 
UNE adi eck seaeonancees puts(S) 
pututline ................. getut(S) 
BNW cc cetienruecuncsaidas putc(S) 
pwadmin .......... pwadmin(C) 
pweheck ............ pwcheck (C) 
WE 5 ac iowonbasntoxrsenns pwd(C) 
C0 OTE svcd ueescnse qsort(S) 
WR Ss oiavcknmes canoer anes quot(C) 
WOME oii dsarnie esses rand(S) 
FANGOM .....6250050 random(C) 
POT cid, vetveseves as ranlib (CP) 
PUEIOE  cxnncasvacasencns ratfor(CP) 
ie eee BED DONE DETECT rcp(C) 
WHOM dis iccccchsorrsewres rdchk(S) 
i) Mae ne renee rere read (S) 


TER sens ceseas directory (S) 


ORG: gs fons cnsasnacss malloc(S) 
i ROE MA rode meen red(C) 
FOGCOID © oo. s5sccseee regcmp (CP) 
WO oi ili cieceveess regex (S) 
tga RE een regex (S) 
TOQGI | ook cde vecness regexp(S) 
WE IOCE sis ac sav ss ets accept(C) 
i ee remote(C) 
S| aie ee ee restore(C) 
fo a restore(C) 
5A at eee fseek(S) 
rewinddir ........... directory (S) 
WT awe asp ay ccinaadeeeiaes rm(C) 
PIU oc, ceukaskverisvas rmdel(CP) 
WOU avin ek cs se taaes rmdir (C) 
SUAS EE a oes acceeces rmuser(C) 
ee case ceins veces rsh(C) 
i GaN ae nea runbig(C) 
spn ee i ee sact(CP) 
NG gers oes eieeeeea sbrk(S) 
WOM casas tie diccstass scanf(S) 
ROCIO oe shes as sccsdiff (CP) 
So a sccsfile (F) 
Do, aaa ae ae sddate(C) 
Sdenter ...........c000 sdenter(S) 
SGICOVE oo ecdscscs.css. sdenter(S) 
aS PRS a ean sdget(S) 
cL _. Sa A Denne nme sdgetv(S) 
(| Eg i eS nee sdiff (C) 
Sdleave .............0.. sdenter(S) 
SOWA onc ccceccsclscses sdgetv(S) 
WOE iy cas Seay cots una sh eves sed(C) 
seed48 ............... drand48(S) 
SCCMGIT .......5..005. directory (S) 
BUI cek cay is'ssevase ce semctl(S) 
SON cco vuciccccscecs semget(S) 
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Pe AVOUT SAG ES | 5 5 sacs pscrecsanwanereiceeiies cee sysadmin(C) 
File system, checking and EOUAMEENE gcoe css vctamsscacssswon: fsck(C) 
PMO VSG, CODSIC TG oven. occ vnc ceace oscctusectveccovseee. mkfs (C) 
BUNS SUBIC AOUIU TA © occ ooscisasscncecachexsdveveeredacsucns setmnt(C) 
PERO Byer, HEOUB Ooo 0 ss vasachcoussccvivseiauetedivastcne. mount(C) 


PLO SVSIBON, TROUSER 3 5 cccssccisinseces sku sureandvsyereaekeaass mount(S) 


File system, names from inodenumbers ..............0c00 ncheck(C) 
PE YSU, GI OERIIE voicc.ssicsn avs assent nas ccananscknowvandhioves quot(C) 
RUN Sy BR MS cain cs eds a ons binssssk voacuksonceuNNeees ustat(S) 
FHS BYStEN), URIMOWATIAG x. sviwsscs cocssesssecsvenvesvviessets umount(S) 
File SYSIOM, UNFIOUNUIAG. ....4.s.c000seescrevaservessvavecsers ved umount(C) 
File, access and modification dates ..........ccceeesecceceees settime(C) 
File, access and modification times ..............cceceecesees utime(S) 
FUG, ACCESS PCITMMING a scas Sccincae cdavescasecsesvaavacinusens chmod(C) 
BAGS BOCES Sods cca vases yaunveexsvevnsaes wwuseevasbes access (S) 
Pile WUC SPECABIGIES  n5icssesesssceniecenscssnsssevesssanss mknod(C) 
PHS UONECK FOR TO MD sisocinssncnacanbcaee surecnecaiveresasekeen rdchk(S) 
Fite, Check stim ate DIOCKS .iscicccssasacseccescevcccsssesvvesse sum(C) 
RR AIT hid oak 1 Blasi devas cain ned unnaeeenduev 3 onda bags close(S) 
Filé, comparing side—by—side .....iccasesssasevseversvecesbts s diff(C) 
FG, COUMSALIN IIE bo 5 ois sicseesnsd ian vesyensaxataesdanassyenee ss diff(C) 
FES COMPAL ING Fads iss scascaaenc ccd vas savnendiesoet bthriosakes cmp (C) 
File, compressing an@expanding ......c0scscessscccsssvcasce pack(C) 
File, concatenating and displaying ..............cesceeceeeees cat(C) 
Beate, COLO ac 5 othe ws hd cnisids cies dia sacanuwcavbanatteetnee: fentl(S) 
File, CONVEMINGARA COPYING «..csciccscssasccadeccecscsesseces dd(C) 
File, COPYING ATCHIMGE iavscvvicsesa canes svt vccasssesxenissesacss cpio(C) 
POS, CODVIDS CUBE So, 0s. sexieverscensvvovsenssesnseatunestness copy(C) 
FUE, COO VND ok oncdaslvisicasccvedauanncsstasisdsiacteasisineeds cp(C) 

File, countinglines, words and characters .............066 we(C) 
PAS CORUIOT TGR. 5 cs sh cxauxddntedcoseeenvisstncidese ne umask(S) 
File, Creation MOGGMMSK 0.0 sccscessscssssecedacecssee Meeseae umask(C) 
FB CEOATIONY. oss cas Bis chews divas baseeeasduriesiacsesiaieiks mknod(S) 
BAG, CTURTON CGS Soisn i cacasadeicidscdacaivectdddedettideccecdes diffmk(CT) 
File, displaying repeated Ine 5 i.cssccscccssassaassecsevesiaes unig (C) 
Bue, CISDIAVIDG Ka i iiavensnchecsraseuscawssadensetesteasannaeys pr(C) 

PS, CUDNCAMOM 15s ios csscncsaverssecsastarecsasbasisnsneabences dup (S) 
FiO, CTTOL ANA BURIUD ii icisesndcesasnvaservucndecsbevensecastecsas ferror(S) 
PUG, BEOU TD LA ileg nas cccacacncnncer ses terseeonetanse yaneteas chgrp(C) 
FUG, HOXACOCUNALGINDIAY. oiiscssasvisasveciacsskesnsasnabustess hd(C) 
FES, DOKAUCCIM BE WIRY sisi a sce sacvnsconewnnws ccavngannveesis hd (M) 
Pb CECE VES Saas ss cece deisveduewsas ox tan ciseetensgavennees what(C) 
PAAR LD 55 ia EAS vcs sega saan vce Wav banekennavenenehs In(C) 

Eile LOOM UINS 5568 SPUR, caus aaetdacwssssas ois torees mannan ee find (C) 
DUEL IOS RING COIR 5 5 sn tacness Vasevevenevetawusaenatesgavanos locking (S) 
UE: TO xcs paths iads whe nck eons ean an aeen Oe eNS chmod(S) 
File MOVING AG TOMMNING once sss dcasevscncinsanvontveweces mv(C) 
BUG S OCERL CUMD 0 aiia sien ves 0 sodas xndinserecunecevncsssmunes od(C) 
PES, OUCRINS id i Cie cco sesaecteicsmivewa vowed oxemeenenecees open(S) 
PC CAPER TD Reo oii chaarien ode doves ae ae CUATRO Series chown(C) 
FIG OWROTSIAD ti oid cdhirences cero versanecenevercbysaneasebents chown(S) 
File, permission and Ownership. ...............ssesecesssecees fixperm(M) 
PEG; PPS CB iad ese vena cu er vied bi vencvedwawstinniiscesceae’s Ip (C) 


MSU Ooty seit oc con snes kx dios ek osai ndbeseeindlacs Ip (M) 


PIC ORANG 5) is HE Selidiss asad sinssevsnns Od bstnacd he eties read(S) 
PR MSN NE i Sore nua: yates sev apsiiv ou uc vacuease vices unlink(S) 
I IIT Sie Ba soy sins seks sak INS Hs da Cea rm(C) 

FUN ANI io ssbb Dcan go igs cace bi seses sbvhesdnksbavseteeaG bfs (C) 

Pile, seleCtitg COMMON LINES. ..;.,,.<es0scnosp0s00-rasneasasnsce comm (C) 
BS I ois 5 « crass Base oven ied nssians oe chsize(S) 
PE NIN ok eset ae 6 Gok cach kon sdanewsusas QGAeORe sort(C) 
PHO; BOUIN S DY COMPEKE, 55.15.55555 000000 scnsssercerercssasaseess csplit(C) 
Rd oe) a a a split(C) 
RR NS gh Gs oo ia dee a kvsdvs Wada peuecnacdenc® stat(S) 
RG AR PRG at eh 5 gis vaavoue oUibae ds ten whasedensiees tmpfile(S) 
EUG, OS WRIA Br oo gs isc ve nevvnip odoin 004s kee TRKS ERR. ftw(S) 

EN A 5s 56 oxen UKs oa Von s orn ade ken file (C) 

File, updates access and modification times............... touch(C) 
PAE AIOE OO GCOUD EA oss sngecinvessisesdensssecusedovsesesans setuid(S) 
BN NO WR cP sry tack ons ca Pens ea seN bao aeack ws more(C) 
PRN 5 WING 5 5 co sine ioadlgine i505he 40d ski eerie write (S) 
PUGRMING  CYEATION goss sé case cdbas dasa vakceescen Re mktemp(S) 
RMA, TCT ON AS a so ccd fe ca ocsu ad chavanckoeeaiceen tmpnam(S) 
FED IOS os IPRS onc Crees ce Gratinnatnceee is lS ferror(S) 

A SMG TERMS TOS oo oc wc eee date cia Nveiexds vixcatienk paste(CT) 
PANNA NEA cbs os ccide cass ces adukonsae tate Iseek(S) 
PHOS REICH OT GOI vig cask cd cc ccansusd vaedacwiaderctesidcacies cut(CT) ; 
Find lites. a SOrted Uist ... <occccesecscesdevelneman lave look(CT) ae 
a 5S | a a re wee ce een ee ae dbm(S) 
Floor, ceiling, and remainder functions .................06. floor(S) 
PO GE ACCU sayin cs bas 85 sso co's oh ove cde an edhe aiiiesse fd(M) 
POY CAS OY cite Fi nnn ss cs eecehss wiceraedauavacsevavanesees diskep(C) 
PIONS, LORMAN 5. pais 0iscszeneconcsersssessesxeesenttn format(C) 
Ere CSS ES OL Re eee, een Wa SOE NE Bae Re seer 8 floor(S) 
Pe FS hii Re va ciccaenee ae hcsn enti newform(C) 
PORE rai OE ig kc tics vdeo Sows oh BiG Rae printf(S) 
EER UG SECTION 5 Reaicii 55 Biss Sd oy oad ow ha Kass eed Dany cee putc(S) 
PER TOT oo cca tah ve vnis Wiss vag ekaea eee puts (S) 
Be OG, cs ah scan i isc edke ase malloc(S) 
EVO DO SC UNF is oy p's vteeabdnsnasidewwneaadaakeuekewes fopen(S) 
Te rE Wy 601 mee st EE nS em ee ee A scanf(S) 
UE OS BS RNS 2 7 ON eo RR ee stat(S) 
FTA NE CSE NOE, swe thes os cohen od att cel fseek(S) 
RTPI RAHN os oye aU gehen db csineae atbdiudseacdseeuee cade time (S) 
PUNCHOI REY SCUMDD seis scansnadunseswrsscnckenuaiane saccades setkey(M) 
PR nies oi ainnin Sh usa denn gue patna dai eoalen ck fread(S) 
CATE MURINE 2 ee a oy ih ye se gos na aide bdcneSo, xlis t(S) 
OPE ce ssc bach as cate eka waa Bhs a dei cds ecvt(S) —, 
SotcHEs TURCHBD 6 icechs.ccs sas ssense> ar RS Re een eR, TO getc(S) 
I racers OY setae Mie Na ys ngs caper nwsawanindeenas ae ee getuid (S) 
on 21 1» LC a cS eae Skee ee Ae ee Me OPP ee a getuid(S) 


no TERENCE ROE oR UE EES ROR NEES BODES AOL & Pa getuid (S) 


Piagh ug 2312 5, 11 AS ee ee en ae ee EAE RE getgrent(S) 
EG TB fa. a a aaa aT SOTO NDT ET SR IREU RS Cr getgrent(S) 
SONI TN oats y sc vke vcs Via wvavcws Gevanbiac padonci Ray getpid(S) 
SOT e og 522 | 1) RR aR Ee eo eon a NN getpid(S) 
AT SOCIOL Spas caducus zivinebadexbasevesisneadaedeeses getpwent(S) 
SAE TUCO srs bp unnasncdiasanscaccoreusenasnaeveas eee getpwent(S) 
BO oA fe asad upc gexoes cancion viunsbeecsseiinaes duauearedes getc(S) 

EE RIN PANE ao ek ee ey cd ccs oe bn ie bce ctime(S) 
Graphics, interpolating CUrVes ............ccccecscsessescececs spline(CP) 
POE EE pcs es ce ss csc ea. bscaecyaipsces cxasdeswaaeeack group(M) 
Be Gt eRe ENT Se Oe Ta Ret Hn ene ee CERT ee grpcheck(C) 
TAs TE UNI or ic cis egos cop erbcek cave neb sak exw getgrent(S) 
MOG BWC AN ejay vices bi xobr end ecceacemeahc na tones newgrp (C) 
pl Se UM GE) sa 003) 1 Sanne et an ER ee nT ssignal(S) 
FIRS SORICH tales SOARAGES io cks ceccccnsacacveasedavscecatess hsearch(S) 
PROM RGRC NING, GOREPIION 5 fc siccccacccexsusasioancncascaasean machine (M) 
PEN sac cyan ak hac aka eeais elses hyphen(CT) 
BPE, OBOE DTG BOI ii oik iss 0h ead cs ead dcusasnnaeseacs sana pesos ace id(C) 
Imagen serial sequence packet protocol handler ......... ips (C) 
BORE BIEN a iicscneasnisnaneseenesuahacescatenebecsanees init (M) 
EI ae arte baci ccesncntg na ak hoes oaks Re aE inode (F) 
UES og 2 SEER Rt ee Pee Rs ERS ARR eI we ins tall(M) 
SHLGTESOR UN DALE. OL DONS icc. cops chexsvassacescinsssedeunsccces parallel(M) 
BOTT GC Uh Bae Ii vig occa cuineseeeaccavencinnssovheeees serial(M) 
BPS (HUN, CONC PBI a icasassccsic cs ecndsvixcdenkecesiseasiabecs abort(S) 
EEE EE 2 ToT 110) ee a eee, OURO Pa NE ORR TP ctype(S) 
RUE cr ot fee ca ars cident ny it et ctype(S) 
ESS, 9 2). Cad 2”, ge Re eee CC eet ctype(S) 
BBM CUE ciccnadinvey Va shen ei sinchvohancts ansade esbaveuseneial ttyname(S) 
Pgs eg BCT Tag 27 aaa ce OTe AUB ELD Oe DOIN ctype(S) 
RE AE TART is sie a Se ae Sia acon rated ae ctype(S) 
SAIN SRC CLOEY ates iat ssa bie co dskosassisbeakessueereeenk ctype(S) 

BA Weta Ne ooo osc sg ames rale uw ceay ves Camees ape eee ies ctype(S) 
eres eg. ea 61: RS See ae eee eee, Dene nnO ctype(S) 
SRT A ora oo cs casks Reb ousng asses bAloseeses tere ctype(S) 
AOR EG occiy 52 edad awa hdd en awe een ctype(S) 
IWUPDETLUNCUON occas sigivesescces aihiag eee waeenlees oasee ieee: ctype(S) 

ee TC 8 TEES) or a Ee Ee EER ONPG Ao ctype(S) 

HP GRO. a ccaia dvsckausie ceiiesnap chaia tax ncpseudtucearesinenerane bessel(S) 

Bh TONE 50%, say cen evar ee ruewactinnse sugeck eaclweken tees bessel(S) 

BUY VUICAUOE 5 saicns wns is Fazinisnde deco nxsexecbenewsdaroraetisesassoes bessel(S) 
Keys, name and function of special ...............sceeceseees keyboard(M) 
MPA AC ON. Siacs tite ncucsag cesta sera raisands toa eninceeas a641(S) 
LANGUAGE USAOS, COPPECUON: sins seuescscvediaevseseceasesveens explain (CT) 
LANGUAGES USAGE GOSCTIPUON cvccssesvedecvavdcstsecesscadenven diction(CT) 
EAS + oy See Renee ORC EPEAT We pt MOA ETNA IEE revere te» banner(C) 
POM WONT: sin cnc os sce bcs canniindic cevnnvisvaadeweseapeanee frexp (S) 


BS ICN od al Eo ARE Er lex(CP) 


BPRS TS noes casi So acad cnodhndeieinvnedacieel hana intro(S) 
Library, screen and cursor functions ............cccccceccees curses (S) 
Library, standard input and output .............. eee ee eees stdio(S) 
ROMG WEA IN TEC CELINE (55555565. 35 lieidesccedeaescies dadesne. line (C) 
LAG DLE, CONCOPPOR ESE 2.0 5dis.c0<ivdsctbeeesecd canenecs Ip (C) 

PS eer COMM OULS OAc iccsececlosiacitecctenscce. Ipadmin(C) 
BO PE eCOr cater ns soe aces Ae res near Ipinit(C) 
Tanne enter, SONG Ulel ss o23.dclesiieeiheel a eset. Ipsched(C) 
StS TOL, BTAUE Se ovncs oo sdicndd ie ntdientciec rn Ipstat(C) 
LARGAr BEAT Se Se chicos cd hk cada oelo cae Isearch(S) 
Link filename to@xisting file i ......c.cc.caccccocsevevvecevees link(S) 
EAN COHOE Sy RIA ak ois rs era ie ela ac ebs dk onbevekes Id(CP) 
EAE COON SA ea als cid cascades oabins eos aaa Id (M) 

List contents Of GireGtary: ..6..66605565c0s cea eedsadescscdesdhccs 1(C) 

LOCATE eS TUNCHEON | A Sib sicss ccccececcedesecedccdececdoeodecccutes ctime (S) 
WS TBCOOG 66 Rei res piecscceedtve datesenedacetiele ek exp (S) 
IORI TON CHO (GT eo iiivcctececces coadeecdtldsehecededhocneclews exp (S) 
EASA TAINS isc eRe coach dere i cuserid(S) 
PRUGINALAING SBE ios iosced locas ache voce logname(S) 
OP orc Ey 5 pee A/S os MRE EER RS 2 Re eee EE ee logname(C) 
Rear TRIE Cee ke. Car eee adc ater ies beni getlogin(S) 
SHNEIOS FORO RTE aii bec swede cs eies sia tial ate ca oeedeoueieuians utmp (M) 
EAigiy Bye ratr gee AE cutouts tiene ds oodecaeasehicikbaves login(M) 
ODM URGES oc oudivewevesacdeeolosseh ue setjmp(S) 
HOERIUMONON- ALL fot cciu dich ccdda Core en I3tol(S) 
DAACTO DEQCESSON FIA cacteee nw eredteNcitid di cdds Howmalewcs, m4(CP) 
MaCTOS, CHOCKIRGUBNRO foie fc ccc0 os Tiosdecsebevscolnoes leat. checkmm (CT) 
Macros, memorandum for line printer ..................006. mm(CT) 
Macros, memorandum for typesetting ................cc000s mmt(CT) 
PUSACTANRS PREINOVAN oo sed oisi os epee hod cos ck tives cle deroff(CT) 
Macros, .8SO CHRYUNTATION fer cneeieeoivele ke bal cdowcecdcaes soelim(CT) 
EO TA OPED OY Oe Bl ee OD at ie POOR OPER EL eae aE mail(C) 
Pe iy eh one ent a Aare eas aliases (M) 
GAEL UAE'S, PIPE 0 does cee cosy s sau ebccbeeciesntsssass man(CT) 
Mathematical téxt for typesetting o0i.6..c6.cicccckcsscseeces eqn(CT) 
Mathematical text for line printer ........0.......ccescecseces neqn(CT) 
Mathematics, Bessel functions ............ccccccccceccocccece bessel(S) 
Mathematics, Euclidean distance .............ccccccccesscecs hypot(S) 
Mathematics, exponential and logarithm functions ..... exp (S) 
Mathematics, hyperbolic functions ................cceeeeees sinh(S) 
Mathematics, log gamma function ..............cceceeceeeees gamma (S) 
Mathematics, trigonometric functions ..............eceee0e trig (S) 
DICTUIY A OCBUON 5. 01505555 caieheerave se win sas cuncvedanives malloc(S) 
Memory, locking in process, text or data ................00. plock(S) 
IMIGHEOTENUE, BOVINE 6) ie vei yank sss viele ewsbeesele sae eese mem(M) 
TCH eae, VINER 550510955 255 ous seve send ota eae ae os mem(M) 
DREGE OTIOU MUCNE ID hh cS a5 ib iad cn fis peas eis SR yee oe memory (S) 


Mesbage CONITGLOPEFATIONS ....0<<ceseceececesdsiasscvcnaccens ms gctl(S) 


POM ME OI oo ia sip dun aso 0 Shade baudv ks ds uundiwis Gin caeiaccdt ms gget(S) 
Message operations............. 509 RARER ARES eon awe adc hehe ms gop (S) 
eect 2) aR a Cte ae A ee PCRS os assert(S) 
POMS DUNES | OUR oes sic onic os sup cauaaenowiokerdnanediasakiuan messages (M) 
Messages, system, displayed on console ............0.c0e0. dmesg(C) 
UEC EOL, A OE oe a ee ee ees aliases (M) 
Wiewot, Bas hash wrOMeaM ssisssdisassconsamanacausdapnensds aliashash(M) 
Micnet, creating and operating ..............ccccecsessscecees netutil(C) 
Mionet, defanlt command . i. cciccccciscastcccccesacccccaceeac micnet(M) 
WECOE, TOL WARIS AR BCOS ooo cans ci saxcunekx da vanccianbucis aliases (M) 
PRCTIEL TODO IG WARES ov oo ciacks envi dubancscckcteeiendcdias aliases (M) 
BASCOM, IIAIOF CAIRO Bes csisnn d skks shina dcsdcinkcctrdexieeeicts daemon.mn(M) 
MUCNEt, SYRLORYVICEDEIRGATION -..66icicicccscccscnsnscsnekicdeas systemid(M) 
POC LORIE BIB 2a os sina snes wav's vcs beonaoineaeeaes top (M) 
PRE TARY BR noice su tvnr oak noua svaneracadoatctiicenl aliases (M) 
eT i EET Ta 0, Ca CN eo ee ee frexp (S) 
WIOUTTCE DC SVSEGIE EADS ocicics.cscascssssancdaensvesercases mnttab(F) 
WAS ICIS ; ACCOSSIRG TIES «5 oss cis csecneseiosedancessssownasé dos (C) 
PRAT ECO R EIN occa Sapa e or 60004 Vanawnnelaueacesbis wun eavwes multis creen (M) 
BRN Rb eins fas setae cdi x sunnier ated ee nlist(S) 
BREEN SE POTN ele eae sienc cian Gen sow sonnsa@leaeacutetarecves nm(CP) 

PUR WIESE ATT nd s.ci nod ca deck divas ocessceeantaoncss waitsem(S) 
OT os OR A aaah RP oe a Be ct Nan os news (C) 
Ey TC ies as censcceiasebe ens cesneeasaevieae dbm(S) 

PTE FE sesh ign ee oto Seo iouumae py he Se ee ee eee null(M) 
CHOC TUG ONG io og os cs cs ace savadvurnnsinesseeeoanie hdr(CP) 
Object fle, printable hanes «0c. .sesscscccsvessecscssescoess strings (CP) 
Object file, relocatable format ............cscccoscssossesseces 86rel(F) 

BPR LE AIO iis iN os on acs tess nd own casnsurecieaswacuassneieeens size(CP) 
Object file, symbols and relocation .............csceceeseeees strip (CP) 
Option, from armiumient VOctor ... .isciscecscscacsesceasveesecs getopt(S) 
CDEP CERO Msc as de ohcessncdesene ses desiabiasesseays lorder(CP) 
PARTE, SRE ooo ons eva nvinin as oo Way evista daecuscecs passwd(M) 
BOT WI ise ae sshd skein Hadas ebaERONOST SEDO pwadmin(C) 
RES CAD osicins sk bu vanes awecayeiccrduvave oun taieees passwd(C) 
ye Te 2 ea a pwcheck(C) 
PERE, FC TCE ao cin dic o's cnn svc 55300 6Rs bose bRaSoRCaaae getpwent(S) 
Password, file entrieS, Writes .......ccccccsccecscescssscsvveses putpwent(S). 
PUSEWIO TA. TOP MERE ais! in csecied sj endeeuvesiesxcseaieees getpw(S) 
BO SII Fag cals aves cds 54 Gh.ck ousalnipn Geena Sew eee getpass(S) 
POUNH RING, CIFCCUNEY BRINE 55 5ssisssacsevisvoesticvcrdasessoss dirname (C) 
PRC AIINES TERI ie cos 5 5 6 vcs avian dkn kv aveecucnadabeaiesiies basename(C) 
Pattern, SCarchinggnd Processing ......cocccosssassvesossers awk(C) 
MOREL, SOONG SUNG ois Calo a 63 3a nv Sahin Ska Hin aaa ones Sa eae grep (C) 

AT COIR Oe ea i icc ee vs teen ie seasesosicannpeden coreeon pack(C) 
ORIN 9G fe vn.o os an Gudoap oder aud noes Kinane reueui anes neees popen(S) 
POE AION, oiosiasccecccs canenssi cass catsassasiacasaieraavessss ptx(CT) 


Arey EOE ES A TOC 9 65505 vk 5s.a0055 ciara nseue vy edabaviwxceanervendt tee(C) 


FE MID vee sinck. bs cavum 6s 0401 aN ead Una eicke usa WNRS OCA pipe(S) 
PIPe, OPCRING BNE CIOSING csc ccersscccccccvesvedevscsccseavecs popen(S) 
POS TCU os aoa Gees eustcnndddadweveaacupentasesaceeaiass. exp (S) 
Prints formatted output of a varargs argument list ........ vprintf(S) 
Printon an IMAGEN printer: iccccccccvoriedacesecsissessucade imprint(C) 
EYOCONS, BIRPTEOIOO Biko cccscccccecwtsaveteivesevensuedesvisddce alarm (S) 
POG ORE CYEREON 555i Save sedecscddevesediedus ioe we fork(S) 
PYOCESS, CREGUEHON DIIOTILY: -o.cas eve ceasvevevecnvewesesecseiees nice (S) 
Process, kecution tinie proGle o...ccisesievewsevececsovsdans profil(S) 
Process, execution times ...... eR ko SEG Let times (S) 
EPOCG Bs CEO Eo ion ca vs ccesncenevede eda vus tw adieudsiees setpgrp(S) 
i BN 2 CIR 1 PEE aE Ra eT Re eee eT ulimit(S) 
PROCESS, 1OCMIG UE WIGIROLY io scccecesseodievicessawecdeisiens lock(S) 
PYOCESS; FROMOTY AUOCATION cocicccccscccecsiscescscccvseecceee sbrk(S) 
Process, real and effective IDS .......cccccsssccccccscccssccecs getuid(S) 
PEOCORS. BIBS occ aeee vs oss ivavcleau es vee a Cea ons Ge ps(C) 
Process, suspension until signal ..............ccccceseeceesees pause(S) 
Process, teMpoOFrary SUSPENSION ......50.c0cccccsccssceseccsses nap (S) 
PYGCORE AORN AG iiss 0s cus ee ines cbceseeivabcessesseeses kill(C) 
PROGGER, COVINA ing 0sa 8 ses aaseeee sa vawev ete tas eee es kill(S) 
PROCESS ; COPE ANOD A 5 bite cic cnc ca wirieweccedesicd ede dee devvets exit(S) 

PE POIOCRE HACE 5 Sass iad sins ce ee SVR AR av ide ptrace(S) 
Process, waiting for background process ...............000. wait(C) 
Process, waiting for child proces ...........ecesceecccevceees wait(S) 

et lel) eg | Se) eee, fe ne cere ack eee Eee ed getpid(S) 
Processor, halts and flushes block i/0 ...............ceeeeees shutdn(S) 
Program listing, €TOss#feference «s.sisscssscesessessscnseesed cref(CP) 
Program listing, ‘Cross=relerence ......6.csieciseeaseseseevees xref(CP) 
PYOSAMPLOCANON iio iiiiessvsciesscascncsavesereseesesctecdens etext(S) 
Fropramiocation; BRES4tast ~ <csiccsciciceciedscesscselecdeee es end(S) 
PEOSTARE A AIDEN ANCE 8. cits ciesscszissestlnn nea make(CP) 
PYOCESS COMMUNICAUON TEPOrt:; 23256. 50.605 56500. eco cdenes ipcs (C) 
PROCESHES, CORTTO1E oo sn okt 555 coin sk bbs ek eb aN ecede tees proctl(S) 
PGE IAF CUTER 0 iia he heeded acre eee es putc(S) 
PHEW ERE Sr oa 6 S55 fo nccc a ecievessvesszeseaiessvaseeeee ees putc(S) 
PRC Th OE iis 6 sso nh 08k 05008 550d 555000 504555550 ea RR es random(C) 
ey Ps esis Be guts 1 Uc) ¢ieane a A ge drand48(S) 
FR AES CUELy FE RE so i es css ase cea beaten eedesgnsscebesestiks rand(S) 

PR RESOT POI 1 A weds s sede osaaseeds céaccveusansssdeenaekes ratfor(CP) 
PORES ro uh vce kde Sy ciden es vous £54¥asndeds teisceeeees malloc(S) 
PRP OUI ii Ss ci on cus'twa seb eae kane neh eenun ese ean regex(S) 
FOUL PIS CICR, SOLS Fie ian sacs nckveseseadecasssdivevenssaeeeoeee setclock(M) 
Regular CXPIR SRO NS ie. Fi... sin ceeeenvisecverearecravtansrmageets regex(S) 
Regular expressions, compile and match ...............0. regexp (S) 
RGLAUIONS, [OMNIS 2 ida cs eawisins vine ueever Nenueaed posaee ee join(C) 
REMI Cer SERVICER ooo bas anerececsitvie stunt ew eee es calendar(C) 
FREI OVE MOSSAGOS Fo ooi oer veo 05e NUS en eNO VaRo es eee Lal reeds ipcrm(C) 
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PBT BIE TOTO o cia sos dos c nh bcdcks won aneccnseuidenens false(C) 


FROTBED VONIS, FONCAIOE SICING  iesics iacsccccccsversssecsececsas yes (C) 
eee ne: Saat OEE PET ree TRERE oar ay ree ey tee: true(C) 
DOO FE ii gus sisin's 1 50s os uh ado ebauda ed oawexa Brews col(CT) 
Seo oe chnSaiea hunch ota acedecseeeraieees fseek(S) 
PR EG os freien sanc 550s dé ari nuaddeeneces eae es chroot(C) 
BORNE OE sa vc 2 dia wae ca eae Dest east elec chroot(S) 
Run acommand too large fornormal memory ............ runbig (C) 
Ree tana nc an Bo ay cucGh untnscdsnakaces canes con taumeeeews secs file (F) 
Goo Gy PINS o iacsaecessinngeansasavekseetmaaeseeeuss comb(CP) 
Ek Ce CI eo ee Ne ae cdc(CP) 
SO CS CORI AIOE oaiscseeavinanca ceases becasspansineyenseees secs diff(CP) 
SCCS Giles, CrASTN GE DOW VETSIONS «606s ccesssccsccsseevecinses delta (CP) 
BES TS OG ge so vacccavenawe swears cndeeedeeten reeceena causes sact(CP) 
Sy ee, TN) os cikeaend eve skanbawvenceens kankenienstEa prs (CP) 
es Rs PRINS in. oak scccidasanesansisienrascdevaeaenayenees rmdel(CP) 
ee OS PRU aoc css sis chun da kavees acs avaes Vucied eases unget(CP) 
SCCS Ries, TEMSEVIIE VOTSIONS. os scccsvscscsnnvceverveceroesnss get(CP) 
SCCS files, creating and maintaining ................eeceeeee admin (CP) 
Se EE AEN bss 2 cs kG Kes sewsea veevaaoavab eon aeean val(CP) 
SCE os COMBOS DEM) 55s dcecinssavsdetsicscatiaxivepeweeeeH help (CP) 
PCPCOR COLON Ree a psnice vos cake vevedciparededndhiesesesaaon setcolor(C) 
ORECOH TANI COMSOLE ox cavinvccentesnsaqccenvassermaeneapig mapkey(M) 
Bs PCI hci iiss scans vine x vupa seus wok nuannedceay coe etiwe sdget(S) 
Ge OE IO ek en ncn ya ha eae vs pe wan ieaet inde sdenter(S) 
AAC TE oi snc as exo La whdbn doe soa dew aes wisindecsdeiawenitte sdgetv(S) 
REAR CE a oi ccs casein suivues sds caatnasnagnesaangeeins tsearch(S) 
Semaphore and record lockingin files .................0e08 lockf(S) 
Semaphore control ............ davukassnbyhokenwaanaaeeapaniren semctl(S) 
SEDIAP OFS GLCIS BO. ios ties sccvescnarcsacsseagennesnnbexgenees semget(S) 
SPOENIAEOEG , CRORIUON os cess dx conga dbs ska nveeriodendcunebnaanees creatsem(S) 
OPA POE ORT irc sy since vacinsvun scien esuvinaaversan acess opensem(S) 
SEMAPHOTE OMBPAUOES «2... <0cccsinegincedvcaieysanouvereapend semop(S) 
SEIN ADH OFS SUMMOBUNS 46655455 0s us cvndoonciensdecraceverermesnes sigsem(S) 
SCM APAOTE, WALES LOL TESOULCE 6 ociiccceesscasereicaenivaewss waitsem(S) 
WE Oe nc cts sot deans vnvunscoaatareia ay eee setuid (S) 
SOPGCONE TOON ooisra vss ces ces vanes ewncsaneaseuedenespannneces getgrent(S) 
BE TWICIN LIQEO ogo x sc svesnnsdvaccascuvuncsia sukeeuncsenvaiens getpwent(S) 
Shared data, attaching and detaching ...............seeeeeee sdget(S) 
Shared data, efitering and leaving ..,.....csccsovecasecesoes sdenter(S) 
Shared data, synchronized acceSS. ........0s.0.cccssecscgees sdgetv(S) 
SHALE MICIMMOLY CORIO! jokes sscencseccessacerwessesecesonensees shmcetl(S) 
SHAVE TICINO EY CEU sas cnsscsivcsisesssspencesenanecessshaneans shmget(S) 
Shared MEMOLVADETALIONS. 6 sicsscsccdsen scacecicecavsawercadens shmop (S) 
BENE sono cine sents Uh cos can a Ai ie ale es sh(C) 
SLL: FOR CUETO septic vos onc oboe s cea a ieneere pew anoacaWan ens rsh(C) 
Pe UINUIAE occ. coders tied cearcceas asi seueviaedemcsenuieered vsh(C) 
RT DUAGERSING so niscaeccsccessiessncselsdswevasnemmbase neces signal(S) 


J~di 


SRT SOLON ook eee pectoral nme mtn one ssignal(S) 


GE EGNOS Aye core ctit eters cel ceva cee emcieeee trig (S) 
EEE MOIS CMY 650. 52.55l5ccnesdtieiee tenet biceeeieeee tsort(CP) 
Pek Bea RR ea 4 tet PES Oo ht te a ee a qsort(S) 
SMR REE oo 558s ncncattaactestaantoeietiaibieie aes spell(CT) 
BOTTA TU PEOR 6 255250560 2Eh Se dadivecacdcedadbilesenneennne printf(S) 
WATS EOE ied os a deo ics dnctaeteeneies Siw bee deed saeetos atau exp (S) 
SPOT PONCAIO 5s oii Scccdedccoceoncverr totic eek wcnne dee catnn, rand(S) 
sscanf{funchOn £22. .ioeesccvecccess POET ert SEL ROPER CETTE IES scanf(S) 
Standard input, reading strings .............c.ecscececeeceeees gets (CP) 
Standard interprocess communications package ........ stdipc(S) 
SEE RTO is 6G ss oie oe CN Fo oc Ce Ciena ne eee stat(F) 
Stauistical BIDCOSSNE s «....ccceccccsccdcesssecdevsdr ences cnc. prep(CT) 
SUE O FURIOUS soon cevce Se dace esdedeolevee a Cackec sateen ck dbm(S) 
igen SRG ets (6): ean he aie ce ee en a ea eee string (S) 
cy og a eed 26 AIR nee eR A string (S) 
SEER e TIC eo 5 Gans cn nce Coes eevee ces aae string (S) 
SUC V EUHCUOR 6.22 one ciavs evens candice cee dbies thceeennes string (S) 
SURO MIT SNORE ooo as ss eth eaG sees aos token nee s tring (S) 
SEE PUTO TIO Bs os on a Sa ea ie A enc ooh Ss tring (S) 
Stream, buffered input and output ............ ce ceceececeeees fread (S) 
UVC AI: WOES = fe sisi sd ceiicesvecdeeoe eo edoaes seen setbuf(S) 
SEPA, CHAPRBISTIA DUE: i iiscsescecieecds sa vecsdseiccscncen, getc(S) 
Stream, Character OUIDUt- <. 66... ccc cececcesecccccccacdccecess putc(S) 
Stream, Closing and fllshing  ..2:2.0005.0..000s00eseceenccceees fclose(S) 
Stream, LOrmeAtted Tut soiesccicsvccecsceseviscescecvuccecescoss scanf(S) 
Stream, formatted output ...0.c.0.cccececescececcesecccccoscecs printf(S) 
StTOaIM, ODENINES Ai. cesiasviaeesstesecesesl ate ce ee fopen(S) 
SULCAI, TOPOSNIGNING 6 0005 ccna caveves cescdeisecs'vieddstesoudecs fseek(S) 
Stream, returning character to ..........ccscececesecececsceees ungetc(S) 
SUSAN, PING IN PU ciccsecc ccc ccccccecseccedccecéuvieseedeeees gets (S) 
SURGee, STP OUT fas os Se cc erica vw eacecvencccedeeedeSinsvade puts (S) 
String, convert to double precision number ............... strtod(S) 
PREETI SOIT ooo ins sin aide das ice se ee Soseonaseaceetecccenk strtol(S) 
SVEP USES CREP AC INO y's coeds oles dv sv Gas's OC oeeSos hecho eee, xstr(CP) 
Ye eg os eo. ghee Re Re OS DAR AST string (S) 
Rg ite LS os 1, a1 ae NR Rg ROS AR nee s tring (S) 
EEE, 5. 5 0 Oi: AM DRDO AERIS Be ERE ett eRe ERT MONEE Se string (S) 
OPT CITE Fs ons Sd as aaa ps ike dean The uke hee s tring (S) 
SOL RGR rpc Cea veu autecay seni Rawrolcawakercuceweeanes string (S) 
BIPDOU TUN CUON cece sidt lige dacccssdsccsbedesdeatvesss ieee string (S) 
ERP he CIN os aes conde Files cu dadocedn Soebeiameeens s tring (S) 
BIS SRE oo Si ocd ved Seolancdescsnetdaee string (S) 
SPEIRS POI U pcos cutasusescteiedd Mose ite caneibhewe eee: s tring (S) 
Suspend execution of commands fora period ............ sleep(C) 
Suspend execution of commands fora period ............ Sleep(S) 
SYStEM, CULFENT NAME : iscccsccc cco coccecccdiceedddeccddicconess uname(C) 
System, Current Mame. 36660605. Sento elslloeec uname(S) 
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pee 


ERE T CIB RISB OO 65 cis csnsnsesvinesucoassas coat ewavasewarersness du(C) 


System, free disk blocks. ........ PNAS RR RON ETO SET df(C) 
Syster, MfOPMALION$i..ssscyosesccssecssecccccesenssesesncecsnee pstat(C) 
System real me ClOCK: sccsssccscessscoseseasevescessesavncaseves clock(M) 
System, StOMPING Lisi ci ccciscsecesivevessceseceussaseervanssvenss haltsys (C) 
System SHUGOWD. ..cicissssedsrescsscssecsassceteesdvaecsesiacets shutdown(C) 
System, super—DIOCK o..365.6cs0ss.cecessesstossesesassaciecavass sync(C) 
System, SUDET—DIOCE f.2 sic cesscsseiscsansenesecssardesasinansess sync(S) 
VALET, TAR oh cscev re Pekwnies es cvattadaceaaseepnees sat enereeaaas stime(S) 
System, XENIX configuration .........sceccsesescseessscseeee config (CP) 
SVS_OXTUBE VATIABIC oo. ccicccscesesscdeccssesteesretsopesbesseasies perror(S) 
SYS_NICIT VATIADIC .....5..c00sccncescasaacseressessanadivesesecsens perror(S) 
Be PERE ee EE) eT Eee Tere eT ee err TTT tbl(CT) 
ERSTE o caenieatehecwsasas tbh iwinnes van vanndoavhes an vew neu ekaan sense ctags (CP) 
evs CUP CRT 6520s Tp ded wos ds Kos nav sian ve tna eeaenedayaratewes trig (S) 

PRPs CEST ooo es £6 ck Gass cs ccna shaves ease eae saennaeah sinh(S) 
Terminal connection, establishes outgoing................ dial(M) 
Terminal connection, establishes outgoing ................ dial(S) 
Terminal interface, general ............ssecsnesercsossvcessenes termio(M) 
Terminal names, Conventional ........ccccssseseccccccccccees term(CT) 
Terminal OVUHORS, SEl ..0..0.00000cessssoseerecveneveseceavessies stty(C) 
Terminal table file fORMIAE cece cccccsscccvescccescuvcsevessessese term(F) 
Terminal ,.Capapilties sicisscccsscccsecoscnstascevedcesssneuvess termcap(M) 
Terminal, capability functions ..........ceceeeeseeeeeeeeeeeees termcap(S) 
"Terminal, Gisbtle LOM «£iisicccsdcesceccsensgedeceensupsesesxes disable (C) 
Terminal, enabling logins .............csccccsscsscsssssescceces enable (C) 
Terminal, enabling Messages .........sceeeseecesesceseseeeeees mesg(C) 
Terria) TGR aS sos s cscs scescd sasecss vnccsicowtecevesccsesy ctermid(S) 
"POPE Gl AD CELT ACE incsc cab ss becetv cess setastetstsecens ee rrtass tty (M) 
Terminal, login file ............sccccesscssesesccscsesccsseccooses ttys (M) 
Terminal, login MOES ...........sceceeeeescesecseeeeececeeceees getty (M) 
Terminal, Speeds and SettingS .........cssseeeeeeeeeeeeeeeees gettydefs (F) 
T CFiitial, MAME HEE occccseensccvvacescncs cessacacsccovseservesiens terminals (M) 
FOPPAINGL, DAIDE iiss ceccccewcneccevexsieseguatadestisinesassoners tty(C) 
Terminal, setting MOES .............sceceeesesesceeeeeceeceece tset(C) 
Terminal, writing to all ............secccsscscereeescsceecscceees wall(C) 
Testing CONCItIONS ...........cceceeneeeeeeeseeeeeeeeeeeeseeenens test(C) 
Text editor, Ed, restricted Version ..........scceeeeeeeeeeeees red(C) 
Pex SCHON, TRE -kccvacessves ds isecesavannessivcensei daeeerszaennss ed(C) 

PERE OAHOE. DDE! cccisiacccissnnndxturkewstuckaneaneaeseesey Annee ex(C) 

TER SUIT, BCTOOD si visnccosissscsccsctascasasncesesassiesassesien vi(C) 

Vert GAHAC. SITCATE ic cscicccvasncessscccasveadondseseveseosv ene sed(C) 
Text formatter for line printer ............seeeeeeeeeeeeeeeeeees nroff(CT) 
Text formatter for typesetter ..........sceeseeeeeeeeeeeeeeenees troff(CT) 
tgetflag function .........ccseeeeeeeeeceeeeeee eee ecesee sen eeeereess termcap(S) 
tgetnum FUNCTION ..........ceeeeeeee eee eeeeeeeeenaeeeeeeaeeneoene termcap(S) 
tgetstr fUNCtION ........cecceeseceeeee essen eeceeeeenaeeneeeneeseees termcap(S) 
tZOto FUNCTION .........ceeceeeseeeeeeneeeeeeeeeneeneeeeeeneeeeees termcap(S) 


toe 


CR ARIOE INET ROUO 5 fc oe cs oot ka veedsn hc kas vaca ntenvedineak time (S) 


RAEN OO Su eb BE ASS six 545 daesau av naka ue Naasecstveeienareyes asktime(C) 
EIETED ZONES BIE WRB ONG iis 50 shines veeccdsennssdeansvadeachsease tz(M) 

ESE DEG Bes Tok 8 Ves EA ET Oe, eae Roe conv(S) 
OCG BET hs 9] 2's ee EO, tn en eon ee ee eRe ee conv(S) 

SP Re os ath Beta hasan cc gaan pete RCC RRS ANS Lies ceases top (M) 
COE CCE 8 is giativvccssnstsacescccssceusteenxctenssaaatiers conv(S) 
PEI PG ON Aas aiid sc <P ew cassy corset dermersreiasee eG termcap(S) 
Pe EE i aici ain Sink eehic oC xray nan ON ae eGR we ctime(S) 
ite CT TROM IRD. oasis x A Vas oe oc ini cane cs nsesiee ores es pack(C) 
WSCreAGAIMETOCIE SYSIOM .. .cccsicsescssccesvesescansessvnceces mkuser(C) 
RISE, OUR BC CEN cstei isso skncydoacs sn cwe bags veeeigayenwunesas whodo(C) 
ECL Ug ar ne Een Te who(C) 
User; removing trons the SySteit 5 .csjssssssocesscssescasesees rmuser(C) 
RI Rs BRON Cr oir vn ssn cc ae uci Nranhgepkse bund tienesins es su(C) 
User, writing toausersterminal ...i.cciveciascacsssieseesis write (C) 
UISETS BIGOT UO ios ov cainnide bs ssesann letras Ressebaecseaeeestas finger(C) 
WES TE RELY AC CO SS ons cccn nssnectedacdsrnanssvenncdneawacve® getut(S) 
MUEYTN TS SLAC BLOC, TLE i steivin:des s cenccnndodovavensseansamecasacawe ttyslot(S) 
Uuep, bdministes control files. cnc i.ecssscssessecenssontecccens uuinstall(C) 
UGE, Clean SPOOhGNOCOLY nsscciicsccsreckarccascacseesnr diye uuclean(C) 
TIO TIRE CIEE cc coin ccacicicndangeencaverceuacaducnuenss uusub(C) 
UTES | GER I vice v ocgicxaa dienes eukudas oecaassneeeneee i uustat(C) ¥ 
WEE ON 20 5 ais x cscea cst nce aba nweyeeedocess deen beeennnn chdir(S) 
WOPrKMES GITECTOTY, NGLTDNAME ...,...0cderesseacseosesscaesceenss getcwd(S) 
UT pd oe Be bass cine cc heen aces aeaea utmp (M) 
PER EDS POOL PPOs os acs cnecccygardunsscuccesssexeccsdncuess boot(M) 
PREIN LA tO OS GPGSS TINK CF ene cxcancecaccvss’ cncescesenssaces dosld (CP) 
WEF NOU a. cee Tos es ce vai wsn ech idenereaeevexe ein bessel(S) 
Oe SUCRE, choc Nyy rshaenniiavensaseiscuace bias ney eisaeia i stieeye bessel(S) 
METAR UCTS AL cde sbs seh caus aienes cua dnes ees siGbsaaviese eI bessel(S) 


I-14 


\ SLE 


Contents 


Commands (C) 


intro 


accept, reject 


acctcom 
accton 
asktime 


assign, deassign 


at, batch 
awk 
backup 
banner 


basename 


be 

bdiff 

bfs 

cal 
calendar 
cat 

cd 

chgrp 
chmod 
chown 
chroot 
clockrate 


custom 
date 


Introduces XENIX commands. 
Allows/prevents print requests 

Searches for and prints process accounting files. 
Turns on accounting. 

Prompts for the correct time of day. 

Assigns and deassigns devices. 

Executes commands at a later time. 
Searches for and processes a pattern in a file. 
Performs incremental file system backup. 
Prints large letters. 

Removes directory names from pathnames. 
Invokes a calculator. 

Compares files too large for diff. 

Scans big files. 

Prints acalendar. 

Invokes a reminder service. 

Concatenates and displays files. 

Changes working directory. 

Changes group ID. 

Changes the access permissions of a file or directory. 
Changes owner ID. 

Changes root directory for command. 

Sets interrupt timer clock frequency. 

Clears inode. 

Reports hard disk block size. 

Compares two files. 

Selects or rejects lines common to two sorted files. 
Copies groups of files. 

Copies files. 

Copies file archives in and out. 

Executes commands at specified times. 
Splits files according to context. 

Calls another XENIX system. 

Allows user to customize XENIX. 

Prints and sets the date. 


dc 

dd 

devnm 

df 

diff 

diff3 

dircmp 
dirname 
disable 

diskcp 

divvy 

dmesg 

dos, doscat, 
doscp, dosdir, 
dosls, dosmkdir, 
dosrm, dosrmdir 
dtype 

du 

dump 
dumpdir 

echo 

ed 

enable 

env 

ex 

expr 

factor 

false 

fdisk 

file 

find 

finger 

fixhdr 

format 

fsck 

getopt 

grep, egrep, fgrep 
grpcheck 


Invokes an arbitrary precision calculator. 


Converts and copies a file. 

Identifies device name. 

Reports the number of free disk blocks. 
Compares two text files. 

Compares three files. 

Compares directories. 

Delivers directory part of pathname. 
Turns off terminals. 

Copies or compares floppy disks. 
Divides disk partitions. 

System messages displayed on console. 


Accesses MS-DOS files. 
Determines disk type. 
Summarizes disk usage. 
Incremental file system backup. 


Prints the names of files on a backup archive. 


Echoes arguments. 
Invokes the text editor. 
Turns on terminals. 


Sets environment for command execution. 


Invokes a text editor. 

Evaluates arguments as an expression. 
Factor anumber. 

Returns with a nonzero exit value. 
Maintains disk partitions. 
Determines file type. 

Finds files. 

Finds information about users. 
Changes binary file header 
Formats floppy disks. 

Checks and repairs file systems. 
Parses command options. 
Searches a file for a pattern. 
Checks group file. 


Closes out the file systems and halts the CPU. 


Displays files in hexadecimal format. 
Prints the first few lines of astream. 
Prints user and group IDs and names. 
Print on an IMAGEN printer. 
Removes messages. 

Process communication report. 


IMA GEN serial sequence packet protocol handler. 


join 

kill 

l 

Ic 

line 

In 
logname 


Ip, lpr, cancel 


Ipadmin 
Ipinit 


Ipsched, Ipshut, 


Ipmove 
Ipstat 
Is 

mail 
mesg 
mkdir 
mkfs 
mknod 
mkuser 
more 
mount 
my 
ncheck 
netutil 
newform 


unpack 


pwcheck 
pwd 


Joins two relations. 

Terminates a process. 

Lists directory contents. 

Lists directory contents in columns. 

Reads one line. 

Makes alink to a file. 

Gets login name. 

Sends files to the lineprinter queue for printing. 
Line printer, configure. 

Line printer, add. 


Start/stop line printer request scheduler. 
Line printer status. 

Gives information about contents of directories. . 
Sends, reads or disposes of mail. 

Permits or denies messages sent to a terminal. 
Makes a directory. 

Constructs a file system. 

Builds special files. 

Adds a login ID to the system. 

Views a file one screen full at atime. 

Mounts a file structure. 

Moves or renames files and directories. 
Generates names from inode numbers. 
Administers the XENIX network. 

Changes format of a text file. 

Logs user in to anew group. 

Prints news items. 

Runs acommand at a different priority. 

Adds line numbers to a file. 

Runs acommand immune to hangups and quits. 
Displays files in octal format. 


Compresses and expands files. 

Changes login password. 

File perusal filter for soft copy terminals. 
Prints files on the standard output. 
Reports process status. 

Reports system information. 

Performs password aging administration. 
Checks password file. 

Prints working directory name. 


sed 
setcolor 
setmnt 
settime 
sh 
shutdown 
sleep 

sort 

split 

stty 


Su 


uuclean 


iV 


Summarizes file system ownership. 

Generates arandom number. 

Copies files across XENIX systems. 

Invokes a restricted version of ed(C). 

Executes commands on aremote XENIX system. 
Invokes incremental file system restorer. 
Removes files or directories. 

Removes directories. 

Removes a user from the system. 

Invokes a restricted shell (command interpreter). 
Run commands too large for memory. 

Prints and sets backup dates. 

Compares files side—by-side. 

Invokes the stream editor. 

Set screen color. 

Establishes /etc/mnttab table. 

Changes the access and modification dates of files. 
Invokes the shell command interpreter. 
Terminates all processing. 

Suspends execution for an interval. 

Sorts and merges files. 

Splits a file into pieces. 

Sets the options for a terminal. 

Makes the user super—user or another user. 
Calculates checksum and counts blocks in a file. 
Updates the super—block. 

Performs file system backups and restores files. 
Delivers the last part of a file. 

Archives files. 

Creates a tee in a pipe. 

Tests conditions. 

Updates access and modification times of a file. 
Translates characters. 

Returns with a zero exit value. 

Sets terminal modes. 

Gets the terminal’s name. 

Sets file—creation mode mask. 

Dismounts a file structure. 

Prints the current XENIX name. 

Reports repeated lines in a file. 

Converts units. 

Clean-up the uucp spool directory. 


uucp, uulog, 
uuname 
uuins tall 
uustat 
uusub 

uuto, uupick 
uux 

vi 

vsh 

wait 

wall 

we 

what 

who 

whodo 

write 

xargs 


yes 
Index (C) 


Copies files from XENIX to XENIX. 
uucp, administers control files. 

Uucp status inquiry and job control. 
Monitor uucp network. 

Public XENIX-to—XENIX file copy. 
Executes command on remote XENIX. 
Invokes ascreen-—oriented display editor. 
Invokes the visual shell. 

Awaits completion of background processes. 
Writes to all users. 

Counts lines, words and characters. 
Identifies files. 

Lists who is on the system. 
Determines who is doing what. 
Writes to another user. 

Constructs and executes commands. 
Prints string repeatedly. 

Index of (C) commands. 
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Name 


intro — Introduces XENIX commands. 


Description 


This section describes use of the individual commands available in 
the XENIX Operating System. Each individual command is labeled 
with either a C, a CP, or a CT for easy reference from other 
volumes. The letter “C” stands for “command”. The letters “P” 
and “T” stand for commands that come with the optional XENIX 
Development System (Programming) and the XENIX Text Process- 
ing System, respectively. For example, the reference date(C) indi- 
cates a reference to a discussion of the date command in the C sec- 
tion; the reference cc(CP) indicates a reference to a discussion of 
the ce command in the XENIX Development System; and the refer- 
ence spell(CT) indicates a reference to a discussion of the spell 
command in the XENIX Text Processing System. The Text Pro- 
cessing and Development Systems are optional supplemental pack- 
ages to the standard Operating System. 


The “‘M” Miscellaneous section contains miscellaneous information 
including a great deal of system maintenance information. Other 
reference sections include the “S” System Services section and the 
“P” File Format section. Both these sections come as part of the 
Programmer’s Reference with the optional Development System. 


Syntax 


Unless otherwise noted, commands described in this section accept 
options and other arguments according to the following syntax: 


name [option(s)] [cmdarg(s)]| 


where: 
name Is the name of an executable file. 
option — noargletter(s) or, 


— argletter <<>optarg 
where <> is optional whitespace. 


noargletter Is a single letter representing an option without an 
argument. 


argletter Is a single letter representing an option requiring an 
argument. 
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optarg Is an argument (character string) satisfying preceding 
argletter. 
cmdarg Is a pathname (or other command argument) not — 
beginning with —. — by itself indicates the standard 
input. 
See Also 


getopt(C), getopt(S) 
Diagnostics 


Upon termination, each command returns 2 bytes of status, one 
supplied by the system and giving the cause for termination, and (in 
the case of “normal” termination) one supplied by the program 
(see wait(S) and exit(S)). The former byte is 0 for normal termina- 
tion; the latter is customarily 0 for successful execution and 
nonzero to indicate troubles such as erroneous parameters, bad or 
inaccessible data. It is called variously “exit code”, “exit status”, 
or “return code”, and is described only where special conventions 
are involved. 


Notes 


Not all commands adhere to the syntax described here. 
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Name 


accept, reject - Allows/prevents print requests to a lineprinter or 
class of printers. 


Syntax 


/usr/lib/accept destinations 
/usr/lib/reject [ -r[ reason | |] destinations 


Description 


Accept allows Ip(C) to accept requests for the named destinations. 
A destination can be either a printer or a class of printers. Use 
Ipstat(C) to find the status of destinations. 


Reject prevents Ip(C) from accepting requests for the named desti- 
nations. A destination can be either a printer or a class of printers. 
Use Ipstat(C) to find the status of destinations. The following 
option is useful with reject: 


-r[reason]| Associates a reason with preventing lp from accepting 
requests. This reason applies to all printers mentioned 
up to the next -r option. Reason is reported by Ip 
when users direct requests to the named destinations. 
Reason is also reported by Ipstat(C). If the -r option 


is not present or the -r option is given without a rea- 
son, a default reason will be used. 


Files 


/usr/spool/|p/* 


See Also 


enable(C), Ip(C), Ipadmin(C), Ipinit(C), lpsched(C), Ipstat(C). 
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Name 


acctcom — Searches for and prints process accounting files. 


Syntax 


acctcom [[options]|[file]]... 


Description 


Acctcom reads file, the standard input, or /usr/adm/pacct, in the 
form described by acct(F) and writes selected records to the stan- 
dard output. Each record represents the execution of one process. 
The output shows the COMMAND NAME, USER, TTYNAME, 
START TIME, END TIME, REAL (SEC), CPU (SEC), MEAN 
SIZE (K), and optionally, F (the fork/exec flag: 1 for fork without 
exec) and STAT (the system exit status). 


The command name is prepended with a # if it was executed with 
super-user privileges. If a process is not associated with a known 
terminal, a ? is printed in the TTYNAME field. 


If no files are specified, and if the standard input is associated with 
a terminal or /dev/null (as is the case when using & in the shell), 
/usr/adm/pacct is read, otherwise the standard input is read. 


If any file arguments are given, they are read in their respective 
order. Each file is normally read forward, i.e., in chronological 
order by process completion time. The file /usr/adm/pacct is usu- 
ally the current file to be examined; a busy system may need several 
files, in which case all but the current file will be found in 
/usr/adm/pacct?. The options are: 


—b Reads backwards, showing latest commands first. 


—f Prints the fork/exec flag and system exit status columns 
in the output. 


—h Instead of showing mean memory size, it shows the frac- 
tion of total available CPU time consumed by the pro- 
cess during its execution. This “hog factor” is computed 


as: 
(total CPU time)/(elapsed time). 
i Prints columns containing the I/O counts in the output. 
—k Instead of memory size, shows total kcore-minutes. 
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==“ 


“= group 


—d mm/dd 


—s time 


—e time 


—n pattern 


-—H factor 


—I number 


—O time 


=—C time 


Shows mean core size (the default). 

Shows CPU factor (user time/(system-time + user-time). ) 
Shows separate system and user CPU times. 

Excludes column headings from the output. 

Shows only processes belonging to terminal /dev/line. 


Shows only processes belonging to user that may be 
specified by a user ID, a login name that is then con- 
verted to a user ID, a # which designates only those 
processes executed with super-user privileges, or ? which 
designates only those processes associated with unknown 
user IDs. 


Shows only processes belonging to group. The group 
may be designated by either the group ID or group 
name. 


Any time arguments following this flag are assumed to 
occur on the given month and day, rather than during 
the last 24 hours. This is needed for looking at old files. 


Shows only those processes that existed on or after time, 
given in the form Ar:min:sec. The :sec or :min:sec may 
be omitted. 


Shows only those processes that existed on or before 
time. Using the same time for both —s and —e shows 
the processes that existed at time. 


Shows only commands matching pattern that may be a 
regular expression as in ed (C) except that + means one 
Or more occurrences. 


Shows only processes that exceed factor, where factor is 
the “hog factor” as explained in option —h above. 
Shows driver processes transferring more characters than 


the cutoff number. 


Shows only those processes with operating system CPU 
time that exceeds time. 


Shows only those processes that exceed time (the total 
CPU time). ) 
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Multiple options have the effect of a logical AND. 


Files 


/etc/passwd 
/usr/adm/pacct 


/etc/group 


See Also 


accton(C), ps(C), su(C), acct(S), acct(F), utmp(M) 


Notes 


ACCTCOM (C) 


Acctcom only reports on processes that have terminated; use ps (C) 


for active processes. 
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Name f 


accton — Turns on accounting. 


Syntax 


accton [file] 


Description 


Accton turns on and off process accounting. If no file is given, If 
file is given, the kernel appends process accounting records. See 
acct (S) and acct (F)). 


Files 
/etc/passwd Used for login name to user ID conversions 
/usr/lib/acct Holds many accounting commands 


/usr/adm/pacct Current process accounting file 
/usr/adm/sulogin Super-user login history file 


/usr/adm/wtmp __Login/logout history file 


See Also 


acctcom(C), acct(S), acct(F), utmp(M) 
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Name ; 


asktime — Prompts for the correct time of day. 


Syntax 


ae /etc/asktime 


Description 


This command prompts for the time of day. You must enter a legal 
time according to the proper format as defined below: 


[Lyy umdd|hhmm 
Here the first mm is the month number; dd is the day number in 
the month; hh is the hour number (24-hour system); the second 
mm is the minute number; yy is the last 2 digits of the year number 
and is optional. The current year is the default if no year is men- 
tioned. 


Examples 


This example sets the new time, date, and year to “11:29 April 20, 
in So sR 


Current system time is Wed Nov 3 14:36:23 PST 1985 
Enter time ([yymmdd]hhmm): 8504201129 


Diagnostics 
If you enter an illegal time, asktime prompts with: 


Try again: 


Notes 


Asktime is normally performed automatically by the system startup 
file /etc/re immediately after the system is booted; however, it may 
be executed at any time. The command is privileged, and can only 
be executed by the super-user. 
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Systems which autoboot will invoke asktime automatically on 
reboot. On these systems, if you don’t enter a new time or press 
return within 1 minute of invoking asktime , the system will use the 
time value it has. If RETURN alone is entered, the time is 
unchanged. 
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Name 


assign, deassign — Assigns and deassigns devices. 


Syntax 
assign [ —u | [ —v ][ —d | [ device ]... 


deassign [ —u | [ —v | [ device ] ... 


Description 


Assign attempts to assign device to the current user. The device 
argument must be an assignable device that is not currently 
assigned. An assign command without an argument prints a list of 
assignable devices along with the name of the user to whom they 
are assigned. 


Deassign is used to “deassign” devices. Without any arguments, 
deassign will deassign all devices assigned to the user. When argu- 
ments are given, an attempt is made to deassign each device given 
as an argument. 


Available options include: 


—d 
Performs the action of deassign. The —d option may be embed- 
ded in device names to assign some devices and deassign others. 


=v 
Gives verbose output. 


—u 
Suppresses assignment or deassignment, but performs error 
checking. 


The assign command will not assign any assignable devices if it can- 
not assign all of them. Deassign gives no diagnostic if the device 
cannot be deassigned. Devices may be automatically deassigned at 
logout, but this is not guaranteed. Device names may be just the 
beginning of the device required. For example, 


assign fd 
should be used to assign all floppy disk devices. Raw versions of 


device will also be assigned, e.g., the raw floppy disk devices 
/dev/rfd? would be assigned in the above example. 
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Note that in many installations the assignable devices such as floppy 
disks have general read and write access, so the assign command 
may not be necessary. This is particularly true on single-user Sys- 
tems. Devices supposed to be assignable with this command should 
be owned by the user asg. The directory /dev should be owned by 
bin and have mode 755. The assign command (after checking for 
use by someone else) will then make the device owned by whoever 
invokes the command, without changing the access permissions. 
This allows the system administrator to set up individual devices 
that are freely available, assignable (owned by asg), or nonassign- 
able and restricted (not owned by asg and with some restricted 
mode). 


Note that the first time assign is invoked, it builds the assignable 
devices table /etc/atab. This table is used in subsequent invoca- 
tions to save repeated searches of the /dev directory. If one of the 
devices in /dev is changed to be assignable (i.e., owned by asg), 
then /etc/atab should be removed (by the super-user) so that a 
correct list will be built the next time the command is invoked. 


Files 


Exit code 0 returned if successful, 1 if problems, 2 if device cannot 
be assigned. 7 
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Name 


at, batch — Executes commands at a later time. 


Syntax 
at time [ date |] [ + increment | 
at -r job ... 


at -I[ job ... | 


Description 


At and batch read commands from the standard input to be exe- 
cuted at a later time. At allows you to specify a time when the 
commands should be executed, while batch executes jobs when the 
system load level permits. 


Standard output and standard error output are mailed to the user 
unless they are redirected elsewhere. The shell environment vani- 
ables, current directory, umask, and ulimit are retained when the 
commands are executed. Open file descriptors, traps, and priori- 
ties are lost. 


A user is permitted to use at if his name appears in the file 
/usr/lib/cron/at.allow. If that file does not exist, the file 
/usr/lib/cron/at.deny is checked to determine if the user should be 
denied access to at. If neither file exists, only root is allowed to 
submit a job. If only the at.deny file exists, global usage is permit- 
ted. The allow/deny files consist of one user name per line. 


The options are: 


time The time may be specified as 1, 2, or 4 digits. One- and two- 
digit numbers are taken to be hours, four digits to be hours 
and minutes. The time may alternately be specified as two 
numbers separated by a colon, meaning hour:minute. A 
suffix am or pm may be appended; otherwise a 24-hour clock 
time is understood. The suffix zulu may be used to indicate 
GMT. The special names noon, midnight, now, and next are 
also recognized. 


date An optional date may be specified as either a month name 
followed by a day number (and possibly year number pre- 
ceded by an optional comma) or a day of the week (fully 
spelled or abbreviated to three characters). Two special 
“days”, today and tomorrow, are recognized. If no date is 
given, today is assumed if the given hour is greater than the 
current hour and tomorrow is assumed if it is less. If the 
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given month is less than the current month (and no year is 
given), next year is assumed. 


increment : 
The optional increment is simply a number suffixed by one of 
the following: minutes, hours, days, weeks, months, or 
years. (The singular form is also accepted.) Thus, legitimate 
commands include: 

at 0815am Jan 24 

at 8:15am Jan 24 

at now + 1 day 

at 5 pm Friday 


—r Removes jobs previously scheduled by the at or 
batchcommand. Unless you are the super-user, you can only 
remove your own jobs. 


—I Lists all the jobs currently scheduled for the invoking user. 


At and batch write the job number and schedule time to standard 
error. Batch submits a batch job. It is almost equivalent to “at 
now,” but with a difference: batch goes into a different queue; at 
now will respond with the error message too late. 


Examples 


The at and batch commands read the commands to be executed at 
a later time from the standard input. Sh(C) provides different ways 
of specifying standard input. Within your commands, it may be 
useful to redirect standard output. 


The following sequence can be used at a terminal: 


batch 
nroff filename > outfile 
<Ctrl-D> (press “Ctrl” and press “D’’) 


This sequence, which demonstrates redirecting standard error to a 
pipe (|), is useful in a shell procedure (the sequence of output 
redirection specifications is significant): 


batch <<! 


nroff filename 2>&1 >outfile | mail 
loginid 
! 
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To have a job reschedule itself, invoke at from within the shell pro- . 
cedure by including code similar to the following within the shell 
file: 


echo “sh shellfile” | at 1900 thursday next week 


Tee Files 
/usr/lib/cron main cron directory 
/usr/lib/cron/at.allow list of allowed users 
/usr/lib/cron/at.deny list of denied users 
/usr/lib/cron/queue scheduling information 
/usr/spool/cron/atjobs spool area 
See Also 


cron(C), kill(C), mail(C), nice(C), ps(C), sh(C) 


Diagnostics 


—S Complains about syntax errors and times out of range. 
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? 
Name 


awk — Searches for and processes a pattern in a file. 


Syntax 


awk [ -Fc ] [ -f programfile | ’program’ ] [ parameters ] [ files ] 


Description 


Awk scans each input file for lines that match patterns specified in 
program or in programfile. When a line of files matches a pattern, 
an associated action may be performed. Awk is useful for compiling 
information, performing arithmetic on input data, and for doing 
iterative or conditional processing. 


The options are: 


-Fc Sets the field separator variable (FS) to the letter “‘c’’. 
The default field separators are tab and space. 


-f Causes awk to take its program from programifile. 

The arguments are: 

programfile A file containing an awk program. 

program An awk program. Programs given on the command 
line must be enclosed in single quotation marks to 
prevent interpretation by the shell. 


parameters May be passed to awk in the form x-..., y=..., etc. 


files The name(s) of the file or files to be processed. If no 
filename is given, the standard input is used. 


An awk program consists of statements in the form: 


pattern { action } 
Pattern-action statements may appear on the awk command line or 
in an awk program file. 


If no pattern is given, all lines in the input file are matched. If no 
action is given, each matched line is displayed on the standard out- 
put. 


A pattern may be a literal string or a regular expression, or a com- 


bination of a regular expression and a field or variable separated by 
operators. 
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Awk also provides two patterns, BEGIN and END, that can be used 
to perform actions before the first line is read and after the last line 
is read, respectively. 


To select a range of lines, use two patterns on a single program 
line, separated by a comma. 


An action is a sequence of statements separated by a semicolon, 
newline, or right brace. See Statements later in this section. 
Variables 


In addition to variables declared and initialized by the user, awk 
has the following program variables: = 


NR Number of records. 
NF Number of fields in a record. 
FS Input field separator. 
OFS Output field separator. 
RS Input record separator. 
ORS Output record separator. 
$0 The current record. 
$1, $n Fields in the current record. 


OFM The output format for numbers. The default is % .6g. 

FILENAME . oo 
: The name of the input file currently being read. 

Arrays may be used to store data. Arrays do not need to be dimen- 


~ sioned before use. For example, “w(i]” denotes the ith item of 
_ array w. | : 


Expressions 


A pattern match with a field or variable may be tested with the fol- 
lowing operators: | 


Matches the regular expression. 
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f 


!" Does not match the regular expression. 


Awk processes relational expressions using the following operators: 


< Less than 
<= Less than or equal to 
== Equal to 


|= Not equal to 
>= Greater than or equal to 
> Greater than 


Patterns can be combined using the operators: 


&E& And 


! Not 


An empty expression-list stands for the whole line. Expressions 
take on string or numeric values as appropriate, and are built using 
the following operators: 


+ Addition 

- Subtraction 

. Multiplication 
/ Division 

% Modulo 


Concatenation is indicated by a blank. 


The following C operators are also available in expressions: 


+ Increment 

me Decrement 

+= Add and assign 

= Subtract and assign 
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*= Multiply and assign 

/= Divide and assign 

= Modulo and assign 
Statements 


if ( conditional ) statement | else statement ] 

while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 
break 

continue 

{ [ statement | ... } 

variable = expression 

print [ expression-list | | >expression ] 

printf format [ , expression-list | | >expression ] 


next #skip remaining patterns on input line 


while Used the same as in C. 


for 


The iterative construction. It can be used the same as in 
the C language, or as an array iterator. 


break Similar to its C counterpart. 


continue Similar to its C counterpart. 


print Prints its arguments on the standard output, or in a file if 


redirected. 


printf Prints expression-list in the format specified in format. See 


printf(S). 


next Stops processing the current record and moves to the 


next record, if any. 


Comments are preceded by a number sign (#). 


Functions 


Awk has the following built-in functions: 


exit(x) Terminates the awk program. If x is given, this value is 


awk’s return value. If x is not given, 0 is returned. If 
the program has an END section, it is invoked before 
termination. — 


exp(x) Exponentiation of the value of x. 
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index(s, t) Returns the starting position of the leftmost 


occurrence of ft in s. If ¢ is not a substring of s, then 
index(s, f) is 0. 


int(x) Returns the largest integer less than or equal to x. If x 
is negative, its value is the smallest integer greater than 
or equal to x. 


length(x) A function whose value is the number of characters in 
the string (x). With no arguments, length is equivalent 
to $0. 

log(x) Natural logarithm of x. 

split(x, y) | Assigns the fields of string x to successive elements of 
array y. 

sqrt(x) Square root of x. 


substr(string, index, length) 
Returns the substring of string that begins at index and 
is length characters long. 
Examples 
The following displays lines in file longer than 72 characters: 
awk {length > 72}? file 
The following prints the first two fields in opposite order: 
awk ’{ print $2, $1 }’ file 


The following adds up the first columns and prints their sum and 
average: 


{ s += $1 } 
END { print "sum is", s, " average is", s/NR } 


The following prints the fields in file in reverse order: 
awk { for (i = NF; i > 0; --i) print $i } file 
The following prints all lines between start/stop pairs: 


awk ’{/start/, /stop/}’ file 
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The following awk program file will print all lines in the object file 
whose first field is different from the first field in the previous line: 


$1 != prev { print; prev = $1 } 


The following program prints a file, filling in page numbers starting 
ae 


/Page/ {$2 = n++;} 
{print} 


The command line has the form: awk -f program n=5 input 


See Also 
grep(C), lex(CP), malloc(S), sed(C) 
XENIX Text Processing Guide 

Notes 
Input whitespace is not preserved on output if fields are involved. 
There are no explicit conversions between numbers and strings. To 
force an expression to be treated as a number, add 0 to it; to force 


it to be treated as a string, concatenate the null string (""") to it. 


This command is explained in detail in the XENIX Text Processing 
Guide. 
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Name 


backup — Performs incremental file system backup. 


Syntax 


backup [ key [ arguments ] filesystem ] 


Description 


Backup copies all files changed after a certain date in the date in 
the filesystem. The key specifies the date and other options about 
the backup, where a key consists of characters from the set 
0123456789kfusd. The meanings of these characters are described 
below: 


f 


Places the backup on the next argument file instead of the 
default device. 


If the backup completes successfully, writes the date of the 
beginning of the backup to the file /etc/ddate. This file 
records a separate date for each file system and each backup 
level. 


This number is the “backup level”. Backs up all files 
modified since the last date stored in the file /etc/ddate for 
the same file system at lesser levels. If no date is determined 
by the level, the beginning of time is assumed; thus the option 
0 causes the entire file system to be backed up. 


For backups to magnetic tape, the size of the tape is specified 
in feet. The number of feet is taken from the next argument. 
When the specified size is reached, backup will wait for reels 
to be changed. The default size is 2,300 feet. 


For backups to magnetic tape, the density of the tape, 
expressed in BPI, is taken from the next argument. This is 
used in calculating the amount of tape used per write. The 
default is 1600. 


This option is used when backing up to a block-structured 
device, such as a floppy disk. The size (in K-bytes) of the 
volume being written is taken from the next argument. If the k 
argument is specified, any s and d arguments are ignored. 
The default is to use s and d. 
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If no arguments are given, the key is assumed to be 9u and a 
default file system is backed up to the default device. 


The first backup should be a full level-O backup: 


backup Ou 


Next, periodic level 9 backups should be made on an exponential 
progression of tapes or floppies: 


backup 9u 


This progression is shown as follows: 


bas Oe ae a A Se 


where backup 1 is used every other time, backup 2 every fourth, 
backup 3 every eighth, etc.) When the level-9 incremental backup 
becomes unmanageable because a tape is full or too many floppies 
are required, a level-1 backup should be made: 


backup lu 


After this, the exponential series should progress as if uninter- 
rupted. These level-9 backups are based on the level-1 backup, 
which is based on the level-O full backup. This progression of lev- 
els of backups can be carried as far as desired. 
The default file system and the backup device depend on the set- 
tings of the variables DISK and TAPE, respectively, in the file 
/etc/default/backup. 

Files 
/etc/ddate Records backup dates of file system/level 


etc/default/backup Default backup information 


See Also 


XENIX Operations Guide 
cpio(C), default(M), dumpdir(C), restore(C), backup(F) 


Diagnostics 
If the backup requires more than one volume (where a volume is 


likely to be a floppy disk or tape), you will be asked to change 
volumes. Press RETURN after changing volumes. 
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Notes 
Sizes are based on 1600 BPI for blocked tape; the raw magnetic 
tape device has to be used to approach these densities. Write 
errors to the backup device are usually fatal. Read errors on the 
file system are ignored. 
It is not possible to successfully restore an entire active root file sys- 
tem. 


Warning 


When backing up to floppy disks, be sure to have enough formatted 
floppies ready before starting a backup. 
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Name 


banner — Prints large letters. 


Syntax 


banner strings 


Description 
Banner prints its arguments (each up to 10 characters long) in large 
letters on the standard output. This is useful for printing names at 
the front of printouts. 


See Also 
echo(C) 
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Name 


basename — Removes directory names from pathnames. 


Syntax 
ee 
basename string [ suffix | 
Description 
Basename deletes any prefix ending in / and the suffix (if present in 
string) from string, and prints the result on the standard output. 
The result is the ‘‘base’’ name of the file, i.e., the filename without 
any preceding directory path and without an extension. It is used 
inside substitution marks (**%) in shell procedures to construct new 
filenames. 
The related command dirname deletes the last level from String and 
prints the resulting path on the standard output. 
Examples 
The following command displays the filename memos on the stan- 
at dard output: 


basename /usr/johnh/memos.old .old 
The following shell procedure, when invoked with the argument 
/usr/src/cmd/cat.c, compiles the named file and moves the output 
to a file named cat in the current directory: 

Cote 

mv a.out ‘basename $1 .c* 


See Also 
dirname(C), sh(C) 
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Name 


bc -- Invokes a calculator. 


Syntax 
be [ —c ][ —1][ file... ] 


Description 


Bc is an interactive processor for a language that resembles C but 
provides unlimited precision arithmetic. It takes input from any 
files given, then reads the standard input. The —l argument stands 
for the name of an arbitrary precision math library. The syntax for 
bc programs is as follows: L means the letters a-z, E means expres- 
sion, S means statement. 


Comments: 


Enclosed in /* and */ 


Names: 


Simple variables: L 
Array elements: L [ E | 


23> 66 


The words “‘ibase’’, ‘‘obase’’, and “‘scale”’ 


Other operands: 


Arbitrarily long numbers with optional sign and decimal point 
(E) 

sqrt (E ) 

length(E) Number of significant decimal digits 

scale (E ) Number of digits right of decimal point 

ep ee ree oh 


Additive operators: 


+ 


Multiplicative operators: 


* 


/ 
% (remainder) 
* (exponentiation) 
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Unary operators: 


ee 
— (prefix and postfix; apply to names) 


Relational operators: 


VATVAN 


Assignment operators: 


=+ 

ae 

=/ 

=% 
Statements: 

E 

{Ss tS 7 

fe ys 

while (E)S 


for(E;E;E)S$S 
null statement 
break 

quit 


Function definitions: 


define L(L,..., L) { 
Pe oe eee eee 
Stu 3 

return ( E ) 
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Functions in —1 math library: 


s(x) Sine 
c(x) Cosine 
e(x) Exponential 
I(x) Log 

ee a(x) Arctangent 
j(n,x) Bessel function 


All function arguments are passed by value. 


The value of a statement that is an expression is printed unless the 
main operator is an assignment. Either semicolons or newlines may 
separate statements. Assignment to scale influences the number of 
digits to be retained on arithmetic operations in the manner of 
dc(C). Assignments to ibase or obase set the input and output 
number radix respectively. 


The same letter may be used as an array, a function, and a simple 
variable simultaneously. All variables are global to the program. 
“Auto” variables are pushed down during function calls. When 
using arrays as function arguments or defining them as automatic 
variables, empty square brackets must follow the array name. 


Bc is actually a preprocessor for dc(C), which it invokes automati- 
cally, unless the —c (compile only) option is present. If the —c 
| option is present, the dc input is sent to the standard output 
ea instead. } 


Example 


The following defines a function to compute an approximate value 
of the exponential function: ; 


scale = 20 
define e(x){ 
auto a, b, c, 1, s 
a=1 
b=1 
=] 
for(i=1; 1==1; i++){ 
a =a*x 
b = b*i 
c = a/b 
if(c == 0) return(s) 
s=stc 
7 } 
} 
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The following prints the approximate values of the exponential 
function of the first ten integers: 


for(i=1; i<=10; i++) e(i) 
Files 
/usr/lib/lib.bc Mathematical library 
/usr/bin/dc Desk calculator proper 


See Also 

dc(C) 

The XENIX User’s Guide 
Notes 


A For statement must have all three E’s. 
Quit is interpreted when read, not when executed. 


Trigonometric values should be given in radians. 
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- 
Name 


bdiff - Compares files too large for diff. 


Syntax 
bdiff file file2 [ n | [-s] 


Description 


Bdiff compares two files, finds lines that are different, and prints 
them on the standard output. It allows processing of files that are 
too large for diff. Bdiff splits each file into n-line segments, begin- 
ning with the first nonmatching lines, and invokes diff upon the 
corresponding segments. The arguments are: 


n The number of lines bdiff splits each file into for processing. 
The default value is 3500. This is useful when 3500-line segments 
are too large for diff. 

—s 
Suppresses printing of bdiff diagnostics. Note that this does not 
suppress printing of diagnostics from diff. 

Sie If filel (orfile2) is a dash (—), the standard input is read. 

The output of bdiff is exactly that of diff. Line numbers are 


adjusted to account for the segmenting of the files, and the output 
looks as if the files had been processed whole. 


Files 


See Also 


diff(C) 


Notes 


Because of the segmenting of the files, bdiff does not necessarily 
find a smallest sufficient set of file differences. 


Specify the maximum number of lines if the first difference is too 
far down in the file for diff and an error is received. 
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Name 


bfs — Scans big files. 


Syntax 


bfs [ - ] name 


Description 


Bfs is like ed (C) except that it is read-only and processes much 
larger files. Files can be up to 1024K bytes and 32K lines, with up 
to 255 characters per line. Bfs is usually more efficient than ed for 
scanning a file, since the file is not copied to a buffer. It is most 
useful for identifying sections of a large file where csplit (C) can be 
used to divide it into more manageable pieces for editing. 


Normally, the size of the file being scanned is printed, as is the size 
of any file written with the w command. The optional dash (-) 
suppresses printing of sizes. Input is prompted for with an asterisk 
(*) by default. If a “P” and a RETURN are typed as in ed, then 
prompting is turned off. The ‘“‘P” acts as a toggle, so prompting 
can be turned on again by entering another “P” and a RETURN. 
Note that messages are given in response to errors only if prompt- 
ing is turned on. 


All address expressions described under ed are supported. In addi- 
tion, regular expressions may be surrounded with two symbols other 
than the standard slash (/) and (?): A greater-than sign (>) indi- 
cates downward search without wraparound, and a less-than sign 
(<) indicates upward search without wraparound. Since b/s uses a 
different regular expression-matching routine from ed, the regular 
expressions accepted are slightly wider in scope (see regex (S)). 
The differences from ed syntax include the fact that parentheses 
and curly braces are special and need not be escaped. Differences 
are listed below: 


+ A regular expression followed by + means one or more 
times. For example, [0-9]+ is equivalent to [0-9][0-9]*. 
{m} {m,} {m,u} 


Integer values enclosed in {} indicate the number of 
times the preceding regular expression is to be applied. m 
is the minimum number and u is a number, less than 256, 
which is the maximum. If only m is present (e.g., {m}), 
it indicates the exact number of times the regular expres- 
sion is to be applied. {m,} is analogous to {m,infinity}. 
The plus (+) and star (*) operations are equivalent to 
{1,} and {0,} respectively. 
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(...)$n The value of the enclosed regular expression is to be © 
returned. The value will be stored in the (n+J)th argu- 
ment following the subject argument. At most ten 
enclosed regular expressions are allowed. Regex makes its 
assignments unconditionally. 


(...) Parentheses are used for grouping. An operator, e.g. *, 
+, { }, can work on a single character or a regular expres- 
sion enclosed in parenthesis. For example, (a*(cb+)*)$0. 


There is also a slight difference in mark names: only the letters “a” 
through ‘“‘z” may be used, and all 26 marks are remembered. 


The e, g, v, k, n, p, q, w, =, ! and null commands operate as 
described under ed except that e doesn’t remember filenames and g 
and v when given no arguments return the line after the line you 
were on. Commands such as ---, #++-, #++=, -12, and +4p 
are accepted. Note that 1,10p and 1,10 will both print the first ten 
lines. The f command only prints the name of the file being 
scanned; there is no remembered filename. The w command is 
independent of output diversion, truncation, or crunching (see the 
xo, xt and xc commands, below). The following additional com- 
mands are available: 


xf file 
Further commands are taken from the named file. When an 
end-of-file is reached, an interrupt signal is received, or an 
error occurs, reading resumes with the file containing the xf. 
Xf commands may be nested to a depth of 10. 


xo | file | 


Further output from the p and null commands is diverted to 
the named file. If file is missing, output is diverted to the stan- 
dard output. Note that each diversion causes truncation or 
creation of the file. 


: label 
This positions a label in a command file. The label is ter- 
minated by a newline, and blanks between the : and the start 
of the Jabel are ignored. This command may also be used to 
insert comments into a command file, since labels need not 
be referenced. 


(., . )xb/regular expression/label 
A jump (either upward or downward) is made to label if the 


command succeeds. It fails under any of the following condi- 
tions: 


1. Either address is not between 1 and §. 
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2. The second address is less than the first. 


3. The regular expression doesn’t match at least one line 
in the specified range, including the first and last lines. 


On success, dot (.) is set to the line matched and a jump is 
made to label. This command is the only one that doesn’t 
issue an error message on bad addresses, so it may be used to 
test whether addresses are bad before other commands are 
executed. Note that the command 


xb/*/ label 


is an unconditional jump. 


The xb command is allowed only if it is read from somewhere 
other than a terminal. If it is read from a pipe only a down- 
ward jump is possible. 


xt number 
Output from the p and null commands is truncated to a max- 
imum of number characters. The initial number is 255. 


xv digit] [ spaces | [value | 
The variable name is the specified digit following the xv. 
Xv5100 or xv5 100 both assign the value 100 to the variable 5. 
Xv61,100p assigns the value 1,100p to the variable 6. To 
reference a variable, put a % in front of the variable name. 
For example, using the above assignments for variables 5 and 
6: 


1,%5p 
1,%5 
%6 


prints the first 100 lines. 


g/%5/p 


globally searches for the characters 100 and prints each line 
containing a match. To escape the special meaning of %, a x 
must precede it. For example, 


g/".*\%[cds]/p 


could be used to match and list lines containing printf charac- 
ters, decimal integers, or strings. 


Another feature of the xv command is that the first line of 
output from a XENIX command can be stored into a variable. 
The only requirement is that the first character of value be a 
!. For example, 
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xv5!cat junk 

lrm junk 

lecho "%5" 
xv6lexpr %6 + 1 


puts the current line in variable 5, prints it, and increments 
the variable 6 by one. To escape the special meaning of ! as 
the first character of value, precede it with a x For example, 


xv7\!date 
stores the value !date into variable 7. 
xbz label 


xbn label 
These two commands test the last saved return code from the 
execution of a XENIX command (!command) or nonzero 
value, respectively, and jump to the specified label. The two 
examples below search for the next five lines containing the 
string size: 


xv55 

pe 

/size/ 

xvS!expr %5 - 1 
lif 0O%5 != 0 exit 2 
xbn | 


xv45 

“4 

/size/ 

xv4lexpr %4-1 
lif 0%4 = 0 exit 2 
xbz | 


xc [switch | 
If switch is 1, output from the p and null commands is 
crunched: if switch is 0 it isn’t. Without an argument, xc rev- 
erses switch. Initially, switch is set for no _ crunching. 
Crunched output has strings of tabs and blanks reduced to 
one blank and blank lines suppressed. 


See Also 


csplit(C), ed(C), regex(S) 
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? 
Diagnostics 


If prompting is turned off, a question mark is printed (?) for errors 
in commands. When prompting is on, self-explanatory error mes- 
sages appear. 
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Name 


brkctl - Allocates data in a far segment. 


Syntax 


char far *brkctl(command, increment, ptr) 
int command; 

long increment, 

char far “ptr; 


Description 


The brkctl system call allocates and deallocated memory in addi- 
tional data segments in small and middle model programs. In order 
for the C compiler to make use of the far pointer return values in 
small and middle model programs, brkctl must be declared to 
return a far pointer. To enable the ‘far’ keyword for small model C 
programs, the compile —Me option must be used. Middle model C 
programs require the ~Mme option. 


The brkctl system call should be used only for dynamically allocat- 
ing additional segments in small and middle model programs. All 
other uses should be avoided in favor of sbrk(S), malloc(S), and 
other standard UNIX system services. 


In the syntax example (found in the preceding section): 


command is. either BR -ARGSEG, BR _NEWSEG, _ or 
BR_IMPSEG. 


increment is a signed long increment. 
‘char far *ptr’ is only used when command is BR_ARGSEG. 


The second argument (increment) may not be greater than 64K 
bytes. The increment may not be more negative than the total 
amount of memory in all far segments plus the amount allocated 
in the near segment after process creation. 


If the command is BR_IMPSEG, and a negative increment 
causes one or more segments to be freed, the ‘segment in ques- 
tion’ (see the Return Values section) is the last remaining seg- 
ment that was not freed. BR_IMPSEG implies the use of the 
last data segment. Unless the process 1s small or middle model 
and currently has only one data segment, a positive increment 
that would overflow the last data segment causes a new segment 
to be allocated. 
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If the command is BR_ARGSEG, the increment may not be 
more negative than the size of the segment. The third argument 
(ptr), is assumed to be a far pointer in all models; the offset 
portion is never used. 


If the command is BR_NEWSEG, the increment may not be 
negative at all. Any memory allocated is guaranteed to be at the 
base of a new segment. 


Return Value 


Brkctl() almost always returns a far pointer to the base of the 
affected region, (char far *)-1 on error. 


When the increment is greater than 0, the return value is a pointer 
to the base of the newly allocated memory. 


When the increment is less than or equal to 0, the return value is a 
pointer to the first illegal byte in the segment in question (usually 
the base of the deallocated memory). If that segment is full (exactly 
64K bytes), the return value will be a pointer to the base of the next 
segment (which may or may not exist). 
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Command Increment Action 
BR_ARGSEG <valid far ptr> report on seg- 


ment 
BR_ARGSEG <valid far ptr> increment 
specified seg- 
ment 
Ye” 
BRL_NEWSEG allocate new 
segment, size = 
0 
BR_-NEWSEG allocate new 
segment, size = 
increment 


BR_IMPSEG report on last 
segment; may 
free up empty 
segment(s). 

BR_IMPSEG increment last 
segment; on 
large model (or 
small and mid- 
dle model with 
mutiple data 
segments) may 
allocate new 
segment. 


See Also 
cc(CP), ld(CP), machine(M), malloc(S), sbrk(S) 


Notes 
Use of the type of low level control possible when using Drkctl is 
not advised. The functionality of brkctl may change in future 
releases. It is best to use the sbrk, brk, and malloc calls rather than 
brkctl. 
Brkctl is currently available only on protected mode XENIX. 


In all models, the ‘near’ data segment must be the first data seg- 
ment. 


Brkctl calls with BR_IMPSEG and a negative increment that would 
affect a shared data segment are refused. 
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Name 


cal — Prints a calendar. 


Syntax 


cal [{ month | year] 


Description 


Cal prints a calendar for the specified year. If a month is also 
specified, a calendar for that month only is printed. If no argu- 
ments are specified, the current, previous, and following months 
are printed, along with the current date and time. The year must 
be a number between 1 and 9999; month must be a number 
between 1 and 12 or enough characters to specify a particular 
month. For example, May must be given to distinguish it from 
March, but S is sufficient to specify September. If only a month 
string is given, only that month of the current year is printed. 


Notes 
Beware that “‘cal 84” refers to the year 84, not 1984. 
The calendar produced is that for England and her colonies. Note 
that England switched from the Julian to the Gregorian calendar in 


September of 1752, at which time eleven days were excised from 
the year. To see the result of this switch, try “cal 9 1752”. 


August 26, 1985 Page 1 


Nek 


CALENDAR (C) CALENDAR (C) 


Name 


calendar — Invokes a reminder service. 


Syntax 


calendar [ — | 


Description 


Calendar consults the file calendar in the user’s current directory 
and mails him lines that contain today’s or tomorrow’s date. Most 
reasonable month-day dates, such as “Sep. 7,” “september 7”, and 
“O/7”, are recognized, but not ““7 September’, S912 or “OI iz. 


On weekends “tomorrow” extends through Monday. Lines that 
contain the date of a Monday will be sent to the user on the previ- 
ous Friday. This is not true for holidays. 


When an argument is present, calendar does its job for every user 
who has a file calendar in his login directory and sends the user the 


results by mail (C). Normally this is done daily, in the early morn- 
ing, under the control of cron (C). 


Files 
calendar 
/usr/lib/calprog To figure out today’s and tomorrow’s dates 
/etc/passwd 


/tmp/cal* 
/usr/lib/crontab 


See Also 
cron(C), mail(C) 


Notes 


To get reminder service, a user’s calendar file must have read per- 
mission for all. 
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Name 


cat - Concatenates and displays files. 


Syntax 


cat( -u][—-s][—-v][—-t][—e ] file... 


Description 


Cat reads each file in sequence and writes it on the standard out- 
put. If no input file is given, or if a single dash (—) is given, cat 
reads from the standard input. The options are: 


—s 
Suppresses warnings about nonexistent files. 


“iu 
Causes the output to be unbuffered. 


=v 
Causes non-printing characters (with the exception of tabs, new- 
lines, and form feeds) to be displayed. Control characters are 
displayed as “°X” (Ctrl-X); the DEL character (octal 0177) is 
printed as ‘“*?.”” Non-ASCII characters (with the high bit set) are 
printed as “M -x,” where x is the character specified by the 
seven low order bits. 


—t Causes a tab to be printed as ““I.” This option is ignored if the 
—v option is not specified. 


—“e€ 
Causes a “$” character to be printed at the end of each line 
(prior to the new-line). This option is ignored if the -v option is 
not set. 


No input file may have the same name as the output file unless it is 
a special file. 

Examples 
The following example displays file on the standard output: 


cat file 


The following example concatenates filel and file2 and places the 
result in file3: 
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cat filel file2 >file3 


The following example concatenates file] and appends it to file2: 


cat filel >> file2 


See Also 


cp(C), pr(C) 


Warning 
Command lines such as: 
cat file 1 file2 > filel 


will cause the original data in file] to be lost; therefore, you must 
be careful when using special shell characters. 
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Name 


cd — Changes working directory. 


Syntax 
cd [ directory | 


Description 


If specified, directory becomes the new working directory; other- 
wise the value of the shell parameter $HOME is used. The process 
must have search (execute) permission in all directories (com- 
ponents) specified in the full pathname of directory. 


Because a new process is created to execute each command, cd 
would be ineffective if it were written as a normal command; there- 
fore, it is recognized and executed by the shell. 


If the shell is reading its commands from a terminal, and the speci- 
fied directory does not exist (or some component cannot be 
searched), spelling correction is applied to each component of 
directory, in a search for the “correct” name. The shell then asks 
whether or not to try and change directory to the corrected direc- 
tory name; an answer of n means “no”, and anything else is taken 
as “‘yes”’. 
Notes 


Wildcard designators do not work with the ed command. 


See Also 
pwd(C), sh(C), chdir(S) 
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Name 


chgrp — Changes group ID. 


Syntax 


chgrp group file ... 


Description 
Chgrp changes the group ID of each file to group. The group may 


be either a decimal group ID or a group name found in the file 
/etc/group. 


Files 
/etc/passwd 
/etc/group 


See Also 


chown(C), chown(S), passwd(M), group(M) 


Notes 


Only the owner or the super-user can change the group ID of a file. 
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Name 


chmod — Changes the access permissions of a file or directory. 


Syntax 


chmod mode file ... 


chmod [who] +—= [permission ...] file ... 


Description 


The chmod command changes the access permissions (or mode) of 
a specified file or directory. It is used to control file and directory 
access by users other than the owner and super-user. The mode 
may be an expression composed of letters and operators (called 
symbolic mode), or a number (called absolute mode). 


A chmod command using symbolic mode has the form: 


chmod [who] +—= [permission ...] filename 


Who is one or any combination of the following letters: 


a 


O 


u 


Stands for “all users”. If who is not indicated on the command 
line, a is the default. The definition of “‘all users” depends on 
the user’s umask. See umask (C). 


Stands for “group”, all users who have the same group ID as 
the owner of the file or directory. 


Stands for ‘“‘others’’, all users on the system. 


Stands for ‘“‘user”, the owner of the file or directory. 


The operators are: 


++ 


Adds permission 
Removes permission 
Assigns the indicated permission and removes all other permis- 


sions (if any) for that who. If no permission is assigned, existing 
permissions are removed. 


Permissions can be any combination of the following letters: 


X 


Execute (search permission for directories) 
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r Read 
w Write 


s Sets owner or group ID on execution of the file to that of the 
owner of the file. The mode ‘‘u+s” sets the user ID bit for the 
file. The mode “gts” sets the group ID bit. Other combina- 
tions have no effect. 


t Saves text in memory upon execution. (‘Sticky bit”, see 
chmod(S)). Only the mode “‘u+t” sets the sticky bit. All other 
combinations have no effect. This mode can only be set by the 
super-user. 


Multiple symbolic modes may be given, separated by commas, on a 
single command line. See the following Examples section for sam- 
ple permission settings. 

A chmod command using absolute mode has the form: 


chmod mode filename 


where mode is an octal number constructed by performing logical 
OR on the following: 


4000 Set user ID on execution 

2000 Set group ID on execution 

1000 Sets the sticky bit (see chmod (S)) 
0400 Read by owner 

0200 Write by owner 

0100 Execute (search in directory) by owner 
0040 Read by group 

0020 Write by group 

0010 Execute (search in directory) by group 
0004 Read by others 

0002 Write by others 

0001 Execute (search in directory) by others 
OOOO No permissions 
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Examples 
Symbolic Mode 
The following command gives all users execute permission for file: 
chmod +x file 


The following command removes read and write permission for 
group and others from file: 


chmod go-rw file 


The following command gives other users read and write permission 
for file: 


chmod o+rw file 


The following commmand gives read permission to group and 
other: 


chmod gtr,o+r file 


Absolute Mode 


The following command gives all users read, write and execute per- 
mission for file: 


chmod 0777 file 


The following command gives read and write permission to all users 
for file: 


chmod 0666 file 


The following command gives read and write permission to the 
owner of file only: 


chmod 0600 file 


See Also 
Is(C), chmod(S) 


Notes 


The user ID, group ID and sticky bit settings are only useful for 
binary executable files. They have no effect on shell scripts. 
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Name 


chown — Changes owner ID. 


Syntax 


chown owner file ... 


Description 
Chown changes the owner ID of the files to owner. The owner may 
be either a decimal user ID or a login name found in the file 
/etc/passwd. | 

Files 
/etc/passwd 
/etc/group 


See Also 


chgrp(C), chown(S), group(M), passwd(M) 
Notes 


Only the owner or the super-user can change a file’s owner or 
group ID. 
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Name 


chroot — Changes root directory for command. 


Syntax 


chroot newroot command 


Description 
The given command is executed relative to the new root. The 
meaning of any initial slashes (/) in pathnames is changed for a 
command and any of its children to newroot. Furthermore, the ini- 
tial working directory is newroot. 
Notice that: 

chroot newroot command >x 

creates the file x relative to the original root, not the new one. 
This command is restricted to the super-user. 
The new root pathname is always relative to the current root even if 
a chroot is currently in effect. The newroot argument is relative to 
the current root of the running process. Note that it is not possible 
to change directories to what was formerly the parent of the new 
root directory; i.e., the chroot command supports the new root as 


an absolute root for the duration of the command. This means that 
‘“/..” is always equivalent to “‘/”’. 


See Also 
chdir(S) 


Notes 


Exercise extreme caution when referencing special files in the new 
root file system. 


command must be under newroot or command is reported: 
command: not found 
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Name 


clockrate — Changes clock rate. 


Syntax 


Toe /etc/clockrate frequency 


Description 

/etc/clockrate alters the interrupt timer clock frequency (different 
from the CPU clock frequency) to bring the system clock in sync 
with the computer’s clock. This frequency is expressed in 
Megahertz (megaHZ) and can be found in the computer’s hardware 
reference manual. 

To set a new clockrate to 1.22878, for example, type: 

# /etc/clockrate 1.22878 


/etc/clockrate is a compiled “‘C” program, which modifies the ker— 
nel found in /xenix. 


/etc/clockrate only needs to be run once, unless you reinstall the 
XENIX distribution floppies. 


Files 


/etc/clockrate 
Notes 


Your computer may not be able to change the clockrate of your 
computer with this utility. 
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Name 


clri - Clears inode. 


Syntax 


/etc/clri file-system i-number ... 


Description 


Clri writes zeros on the 64 bytes occupied by the inode numbered 
i-number. File-system must be a special filename referring to a dev- 
ice containing a file system. After clri is executed, any blocks in 
the affected file will show up as “‘missing” if the file system is 
checked with fsck(C). Use clri only in emergencies and exercise 
extreme care. 


Read and write permission is required on the specified file-system 
device. The inode becomes allocatable. 


The primary purpose of this routine is to remove a file which, for 
some reason, does not appear in a directory. If you use clri to des- 
troy an inode which does appear in a directory, track down the 
entry and remove it. Otherwise, when the inode is reallocated to 
some new file, the old entry will still point to this file. At that 
point removing the old entry will destroy the new file. The new 
entry will again point to an unallocated inode, so the whole cycle 1S 
likely to be repeated again and again. 


See Also 


fsck(C), ncheck(C) 


Notes 


If the file is open, clri is likely to be ineffective. 
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Name 


cmchk — Reports hard disk block size. 


Syntax 
Tet emchk 
Description 
Reports the hard disk block size (BSIZE) in bytes. 
cogs 
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Name 


cmp — Compares two files. 


Syntax 
cmp [ —1 ][ —s | filed file2 


Description 
Cmp compares two files and, if they are different, displays the byte 
and line number of the differences. If file] is —, the standard input 
is used. 


The options are: 


—| Prints the byte number (decimal) and the differing bytes 
(octal) for each difference. 


~sS Returns an exit code only, 0 for identical files, 1 for different 
files and 2 for an inaccessible or missing file. 


This command should be used to compare binary files; use diff (C) 
or diff3 (C) to compare text files. 

See Also 
comm(C), diff(C), diff3(C) 


Diagnostics 


Exit code 0 is returned for identical files, 1 for different files, and 2 
for an inaccessible or missing argument. 
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Name 


comm — Selects or rejects lines common to two sorted files. 


Syntax 
— comm [ — [ 123 ] ] file1 file2 


Description 


Comm reads file] and file2, which should be ordered in ASCII col- 
lating sequence (see sort (C)), and produces a three-column output: 
lines only in file]; lines only in file2 ; and lines in both files. The 
filename — means the standard input. 


Flags 1, 2, or 3 suppress printing of the corresponding column. 
Thus comm —12 prints only the lines common to the two files; 
comm —23 prints only lines in the first file but not in the second; 
comm —123 is a no-op. 

See Also 


cmp(C), diff(C), sort(C), uniq(C) 
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Name 


copy — Copies groups of files. 


Syntax 


copy [ option |]... source... dest 


Description 


The copy command copies the contents of directories to another 
directory. It is possible to copy whole file systems since directories 
are made when needed. 


If files, directories, or special files do not exist at the destination, 
then they are created with the same modes and flags as the source. 
In addition, the super-user may set the user and group ID. The 
owner and mode are not changed if the destination file exists. 
Note that there may be more than one source directory. If so, the 
effect is the same as if the copy command had been issued for each 
source directory with the the same destination directory for each 


copy. 


Under XENIX 3.0, options do not have to be given as separate 
arguments, and may appear in any order, even after the other argu- 
ments. The arguments are: 


—a Asks the user before attempting a copy. If the response 


does not begin with a “y”, then a copy is not done. This 
option also sets the —ad option. 


| Uses links instead whenever they can be used. Otherwise 
a copy is done. Note that links are never done for special 
files or directories. 


—n Requires the destination file to be new. If not, then the 
copy command does not change the destination file. The 
—n flag is meaningless for directories. For special files an 
—n flag is assumed (i.e., the destination of a special file 
must not exist). 


—O If set then every file copied has its owner and group set to 
those of the source. If not set, then the file’s owner is the 
user who invoked the program. 


—-m If set, then every file copied has its modification time and 


access time set to that of the source. If not set, then the 
modification time is set to the time of the copy. 


August 26, 1985 Page 1 


COPY (C) COPY (C) 


a § If set, then every directory is recursively examined as it is 
encountered. If not set then any directories that are found 
are ignored. 


—ad Asks the user whether an —r flag applies when a directory 
is discovered. If the answer does not begin with a “‘y”’, 
then the directory is ignored. 


Vv If the verbose option is set messages are printed that reveal 
what the program is doing. 


source This may be a file, directory or special file. It must exist. 
If it is not a directory, then the results of the command are 
the same as for the cp command. 


dest The destination must be either a file or directory that is 
different from the source. 


If the source and destination are anything but directories, then copy 
acts just like a cp command. If both are directories, then copy 
copies each file into the destination directory according to the flags 
that have been set. 


Notes 


Special device files can be copied. When they are copied, any data 
associated with the specified device is not copied. 


August 26, 1985 Page 2 


CP (C) CP (C) 


Name 


cp — Copies files. 


Syntax 
cp file1 file2 


cp files directory 


Description 


There are two ways to use the cp command. With the first way, 
filel is copied to file2. Under no circumstance can file] and file2 
be identical. With the second way, directory is the location of a 
directory into which one or more files are copied. 


See Also 
copy(C), cpio(C), In(C), mv(C), rm(C), chmod(S) 


Notes 


Special device files can be copied. If the file is a named pipe, then 
the data in the pipe is copied to a regular file. Similarly, if the file 
is a device, then the file is read until the end-of-file is reached, and 
that data is copied to a regular file. It is illegal to copy a directory 
to a file. 


August 26, 1985 Page 1 


CPIO (C) CPIO (C) 


Name 


cpio — Copies file archives in and out. 


Syntax 
cpio —o [ acBv | 
cpio —i [ Bcdmrtuv | [ patterns | 


cpio —p [ adlmruv | directory 


Description 


Cpio —o (copy out) reads the standard input to obtain a list of 
pathnames and copies those files onto the standard output together 
with pathname and status information. 


Cpio —i (copy in) extracts from the standard input (which is 
assumed to be the product of a previous cpio —o) the names of 
files selected by zero or more patterns given in the name-generating 
notation of sh(C). In patterns, the special characters ?, *, and 
[...] match the slash (/ ) character. The default for patterns is * 
(i.e., select all files). 


Remember to escape special characters to prevent expansion by the 
shell. 


Cpio —p (pass) copies out and in during a single operation. Desti- 
nation pathnames are interpreted relative to the named directory. 


The meanings of the available options are: 


al Resets access times of input files after they have been 
copied. 


—B Blocks input/output 5,120 bytes to the record (does not 
apply to the pass option; meaningful only with data directed 
to or from raw devices). 


—d Directories are created as needed. 

—C Writes header information in ASCII character form for por- 
tability. 

-r Interactively renames files. If the user types a null line, the 


file is skipped. 
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—t Prints a table of contents of the input. No files are created. 


—uU Copies unconditionally (normally an older file will not 
replace a newer file with the same name). 


—v Verbose: causes a list of filenames to be printed. When 
used with the —t option, the table of contents looks like the 
output of an Is —] command (see Js (C)). 


—| Whenever possible, links files rather than copying them. 
Usable only with the —p option. 


—m Retains previous file modification time. This option is 
ineffective on directories that are being copied. 
Examples 


The first example below copies the contents of a directory into an 
archive; the second duplicates a directory hierarchy: 


ls | cpio -o >/dev/fd 


cd olddir 
find . —print | cpio —pdl newdir 


Or: 
find . —print | cpio -oB >/dev/rfd 


See Also 
ar(CP), find(C), cpio(F) 


Notes 


Pathnames are restricted to 128 characters. If there are too many 
unique linked files, the program runs out of memory to keep track 
of them and thereafter linking information is lost. Only the super- 
user can copy special files. 
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Name 


cron — Executes commands at specified times. 


Syntax 


/etc/cron 
crontab [file] 
crontab —r 
crontab —1 


Description 


Cron is the clock daemon that executes commands at specified 
dates and times according to the instructions in the files located in 
/usr/spool/cron/crontabs. Regularly scheduled commands can be 
specified according to instructions found in crontab files; users can 
submit their own crontab file via the crontab command. Com- 
mands which are to be executed only once may be submitted via 
the at command. Because cron never exits, it should be executed 
only once. This is best done by running cron from the initialization 
process through the file /etc/re. 


Crontab copies the specified file, or standard input if no file is 
specified, into a directory that holds all users’ crontabs. The - 
crontab file in the crontabs directory is given the user’s login name. 
The -r option removes a user’s crontab from the crontab directory. 
Crontab -1 will list the crontab file for the invoking user. 


A user is permitted to use crontab if their name appears in the file 
/Jusr/lib/cron/cron.allow. If that file does not exist, the file 
/usr/lib/cron/cron.deny is checked to determine if the user should 
be denied access to crontab. If neither file exists, only root is 
allowed to submit a job. Global usage is permitted by the existance 
of an empty cron.deny file. cron.deny is checked only if cron.allow 
does not exist. The allow/deny files consist of one user name per 
line. 


The crontabs files consist of lines of six fields each. The fields are 
separated by spaces or tabs. The first five are integer patterns that 
specify the minute (0-59), hour (0-23), day of the month (1-31), 
month of the year (1-12), and day of the week (0-6, with 0=-Sun- 
day). Each of these patterns may contain: 


— A number in the (respective) range indicated above 


~ Two numbers separated by a minus (indicating an inclusive 
range) 
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- A list of numbers separated by commas (meaning all of these 
numbers) 


- An asterisk (meaning all legal values) 


Note that the specification of days may be made by two fields (day 
of the month and day of the week). If both are specified as a list of 
elements, both are adhered to. For example, 0 O 1,15 * 1 would 
run a command on the first and fifteenth of each month, as well as 
on every Monday. To specify days by only one field, the other field 
should be set to * (for example, 0 0 * * 1 would run a command 
only on Mondays). 


The sixth field is a string that is executed by the shell at the 
specified time(s). A % in this field is translated into a newline 
character. Only the first line (up to a % or end-of-line) of the 
command field is executed by the shell. The other lines are made 
available to the command as standard input. 


The shell is invoked from your $HOME directory with an arg0 of 
sh. Users who desire to have their .profile executed must explicitly 
do so in the crontab file. Cron supplies a default environment for 
every shell, defining HOME, LOGNAME, SHELL (=/bin/sh), and 
PATH (=:/bin:/usr/bin:/usr/Ibin ). 


Cron-examines the crontabs directory periodically to see if it has 
changed; if it has, cron reads it. Thus it takes only a short while 
for entries to become effective. 


Examples 


An example crontabs file follows: 


47 ** /etc/sa -s > /dev/null 

04*** calendar — 

Se idling find /usr/preserve —mtime +7 —a -exec rm —f {} ; 
304111 /usr/lib/uucp/cleanlog 

404*** find / -name ’#*’ —atime +3 -exec rm -f {} ; 
0,5, 10, 15,20,25,30,35,40,45,50,55 * * * * /usr/lib/atrun 


0, 10,20,30,40,50 * * * */etc/dmesg — > >/usr/adm/messages 
1,21,41 * * * * (echo -n’ ’; date; echo ) >/dev/console 


A history of all actions by cron can be recorded in 
/usr/lib/cron/log. This logging occurs only if the variable CRON- 
LOG in /etc/default/cron is set to YES. By default this value is set 
to NO and no logging occurs. If logging should be turned on, be 
sure to monitor the size of /usr/lib/cron/log so that it doesn’t 
unreasonably consume disk space. 
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Files 
l i /usr/lib/cron 


/usr/spool/cron/crontabs/* 


CRON (C) 


main cron directory 


spool area 


| /usr/lib/cron/log accounting information 
~ /usr/lib/cron/cron.allow list of allowed users 
/usr/lib/cron/cron.deny list of denied users 
/usr/lib/cron/.proto cron environment information 
/etc/default/cron cron logging default information 
See Also 
at(C), sh(C) 
Notes 
Cron reads the files in the crontabs directory only when there is a 
change, but it reads the in—core version of the tables periodically. 
coe Users should remember to redirect the standard output and stan- 
cn” dard error of their commands! If this is not done, any generated 


output or errors will be mailed to the user. 
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Name 


csh — Invokes a shell command interpreter with C-like syntax. 


Syntax 
csh [ -cefinstvVxX ][ arg... ] 


Description 


csh is a command language interpreter. It begins by executing com- 
mands from the file .cshre in the home directory of the invoker. If 
this is a login shell, it also executes commands from the file .login 
there. In the normal case, the shell begins reading commands from 
the terminal, prompting with % . Processing of arguments and the 
use of the shell to process files containing command scripts will be 
described later. 


The shell then repeatedly performs the following actions: a line of 
command input is read and broken into words. This sequence of 
words is placed on the command history list and then parsed. 
Finally, each command in the current line is executed. 


When a login shell terminates, it executes commands from the file 
-logout in the user’s home directory. 


Lexical structure 


The shell splits input lines into words at blanks and tabs with the 
following exceptions. The characters &, |, ;, <, >, (, ), form 
separate words. If doubled in &&, ||, <<, or >>, these pairs 
form single words. These parser metacharacters may be made part 
of other words, or prevented their special meaning, by preceding 
them with \, A newline preceded by a \is equivalent to a blank. 


In addition, strings enclosed in matched pairs of quotations, °, ~ or 
", form parts of a word; metacharacters in these strings, including 
blanks and tabs, do not form separate words. These quotations 
have semantics to be described subsequently. Within pairs of \or " 
characters, a newline preceded by ach gues a true newline charac- 
ter. 


When the shell’s input is not a terminal, the character # introduces 
a comment which continues to the end of the input line. It does 
not have this special meaning when preceded by \ and placed inside 
the quotation marks *, *, and ”. 
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Commands 


A simple command is a sequence of words, the first of which speci- 
fies the command to be executed. A simple command or a 
sequence of simple commands separated by | characters forms a 
pipeline. The output of each command in a pipeline is connected 
to the input of the next. Sequences of pipelines may be separated 
by ;, and are then executed sequentially. A sequence of pipelines 
may be executed without waiting for it to terminate by following it 
with a &. Such a sequence is automatically prevented from being 
terminated by a hangup signal; the nohup command need not be 
used. 


Any of the above may be placed in parentheses to form a simple 
command (which may be a component of a pipeline, etc.) It is also 
possible to separate pipelines with | | or && indicating, as in the C 
language, that the second is to be executed only if the first fails or 
succeeds respectively. (See Expressions. ) 


Substitutions 


The following sections describe the various transformations the 
shell performs on the input in the order in which they occur. 


History Substitutions 


History substitutions can be used to reintroduce sequences of 
words from previous commands, possibly performing modifications 
on these words. Thus, history substitutions provide a generalization 
of a redo function. 


History substitutions begin with the character ! and may begin any- 
where in the input stream if a history substitution is not already in 
progress. The ! may be preceded by a \ to prevent its special mean- 
ing; a ! is passed unchanged when it is followed by a blank, tab, 
newline, =, or (. History substitutions also occur when an input 
line begins with *. This special abbreviation will be described later. 


Any input line which contains history substitution is echoed on the 
terminal before it is executed as it could have been entered without 
history substitution. 


Commands input from the terminal which consist of one or more 
words are saved on the history list, the size of which is controlled 
by the history variable. The previous command is always retained. 
Commands are numbered sequentially from 1. 
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For example, consider the following output from the history com- 
mand: 


9 write michael 
10 ex write.c 

11 cat oldwrite.c 
12 diff *write.c 


The commands are shown with their event numbers. It is not usu- 
ally necessary to use event numbers, but the current event number 
can be made part of the prompt by placing a ! in the prompt string. 


With the current event 13 we can refer to previous events by event 
number !11, relatively as in !-2 (referring to the same event), by a 
prefix of a command word as in !d for event 12 or !w for event 9, 
or by a string contained in a word in the command as in !?mic? 
also referring to event 9. These forms, without further modifica- 
tion, simply reintroduce the words of the specified events, each 
separated by a single blank. As a special case !! refers to the previ- 
ous command; thus !! alone is essentially a redo. The form !# 
references the current command (the one being entered). It allows 
a word to be selected from further left in the line, to avoid retyping 
a long name, as in !#:1. 


To select words from an event, we can follow the event specifica- 
tion by a : and a designator for the desired words. The words of a 
input line are numbered from 0, the first (usually command) word 
being 0, the second word (first argument) being 1, and so on. The 
basic word designators are: 

0 First (Command) word 

n nth argument 

“First argument, i.e. 1 

$ Last argument 

‘ Word matched by (immediately preceding) ?s? search 


xy 
Range of words 


-y Abbreviates 0-y 
* Abbreviates *-$, or nothing if only 1 word in event 
x * Abbreviates x -$ 


x- Like x* but omitting word $ 
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The : separating the event specification from the word designator 
can be omitted if the argument selector begins with a’, $, *-or %. 
After the optional word designator, a sequence of modifiers can be 
placed, each preceded bya:. The following modifiers are defined: 


h Removes a trailing pathname component 


r Removes a trailing .xxx component 


s/l/r/ 
Substitutes / for r 


t Removes all leading pathname components 

& Repeats the previous substitution 

g Applies the change globally, prefixing the above 

p Prints the new command but does not execute it 

q Quotes the substituted words, preventing substitutions 

x Like q, but breaks into words at blanks, tabs, and newlines 


Unless preceded by a g, the modification is applied only to the first 
modifiable word. In any case it is an error for no word to be appli- 
cable. 7 


The left side of substitutions are not regular expressions in the 
sense of the editors, but rather strings. Any character may be used 
as the delimiter in place of /; a \ quotes the delimiter into the / and 
r strings. The character & in the right side is replaced by the text 
from the left. A \ quotes & also. A null / uses the previous string 
either from a/ or from a contextual scan string s in !?s?. The trail- 
ing delimiter in the substitution may be omitted if a newline follows 
immediately as may the trailing ? in a contextual scan. 


A history reference may be given without an event specification, 
e.g., !$. In this case the reference is to the previous command 
unless a previous history reference occurred on the same line in 
which case this form repeats the previous reference. Thus 
'29f00?7!$ gives the first and last arguments from the command 
matching ?fo00?. 


A special abbreviation of a history reference occurs when the first 
nonblank character of an input line is a*. This is equivalent to es 
providing a convenient shorthand for substitutions on the text of 
the previous line. Thus “Ib’lib fixes the spelling of lib in the previ- 
ous command. Finally, a history substitution may be surrounded 
with { and } if necessary to insulate it from the characters that fol- 
low. Thus, after Is -ld ~paul we might do !{l}a to do ls —Id “paula, 
while !la would look for a command starting la. 
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Quotations With ° and “ 


The quotation of strings by “ and " can be used to prevent all or 
some of the remaining substitutions. Strings enclosed in “° are 
prevented any further interpretation. Strings enclosed in " are vari- 
able and command expansion may occur. 


In both cases, the resulting text becomes (all or part of) a single 
word; only in one special case (see Command Substitution below) 
does a " quoted string yield parts of more than one word; “ quoted 
strings never do. 


Alias Substitution 


The shell maintains a list of aliases which can be established, 
displayed and modified by the alias and unalias commands. After 
a command line is scanned, it is parsed into distinct commands and 
the first word of each command, left-to-right, is checked to see if it 
has an alias. If it does, then the text which is the alias for that 
command is reread with the history mechanism available as though 
that command were the previous input line. The resulting words 
replace the command and argument list. If no reference is made to 
the history list, then the argument list is left unchanged. 


Thus if the alias for ls is ls -1 the command “‘Is /usr” would map to 
“Is -1 /usr”’. Similarly if the alias for lookup was “grep !* 
/etc/passwd” then “lookup bill” would map to “grep bill 
/etc/passwd”’. 


If an alias is found, the word transformation of the input text is 
performed and the aliasing process begins again on the reformed 
input line. Looping is prevented if the first word of the new text is 
the same as the old by flagging it to prevent further aliasing. Other 
loops are detected and cause an error. 


Note that the mechanism allows aliases to introduce parser 
metasyntax. Thus we can alias print ‘pr \!* | lpr” to make a com- 
mand that paginates its arguments to the lineprinter. 


Variable Substitution 


The shell maintains a set of variables, each of which has a list of 
zero Or more words as its value. Some of these variables are set by 
the shell or referred to by it. For instance, the argv variable is an 
image of the shell’s argument list, and words of this variable’s value 
are referred to in special ways. 


The values of variables may be displayed and changed by using the 


set and unset commands. Of the variables referred to by the shell a 
number are toggles; the shell does not care what their value is, only 
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whether they are set or not. For instance, the verbose variable is a 
toggle which causes command input to be echoed. The setting of 
this variable results from the -v command line option. 


Other operations treat variables numerically. The at-sign (@) com- 
mand permits numeric calculations to be performed and the result 
assigned to a variable. However, variable values are always 
represented as (zero or more) strings. For the purposes of numeric 
operations, the null string is considered to be zero, and the second 
and subsequent words of multiword values are ignored. 


After the input line is aliased and parsed, and before each com- 
mand is executed, variable substitution is performed, keyed by dol- 
lar sign ($) characters. This expansion can be prevented by preced- 
ing the dollar sign with a backslash (\) except within double quota- 
tion marks (") where it always occurs, and within single quotation 
marks (°) where it never occurs. Strings quoted by back quotation 
marks (*) are interpreted later (see Command substitution below) so 
dollar sign substitution does not occur there until later, if at all. A 
dollar sign is passed unchanged if followed by a blank, tab, or end- 
of-line. 


Input and output redirections are recognized before variable expan- 
sion, and are variable expanded separately. Otherwise, the com- 
mand name and entire argument list are expanded together. It is 
thus possible for the first (command) word to generate more than 
one word, the first of which becomes the command name, and the 
rest of which become arguments. 


Unless enclosed in double quotation marks or given the :q 
modifier, the results of variable substitution may eventually be com- 
mand and filename substituted. Within double quotation marks (") 
a variable whose value consists of multiple words expands to a por- 
tion of a single word, with the words of the variable’s value 
separated by blanks. When the :q modifier is applied to a substitu- 
tion, the variable expands to multiple words with each word 
separated by a blank and quoted to prevent later command or 
filename substitution. 


The following sequences are provided for introducing variable 
values into the shell input. Except as noted, it is an error to refer- 
ence a variable which is not set. 


$name 

${name} 
Are replaced by the words of the value of variable name, each 
separated by a blank. Braces insulate name from following 
characters which would otherwise be part of it. Shell vari- 
ables have names consisting of up to 20 letters, digits, and 
underscores. 
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If name is not a shell variable, but is set in the environment, then 
that value is returned (but : modifiers and the other forms given 
below are not available in this case). 


$name[selector] 

${name[selector]} 
May be used to select only some of the words from the value 
of name. The selector is subjected to $ substitution and may 
consist of a single number or two numbers separated by a -. 
The first word of a variables value is numbered 1. If the first 
number of a range is omitted it defaults to 1. If the last 
member of a range is omitted it defaults to $#name. The 
selector * selects all words. It is not an error for a range to 
be empty if the second argument is omitted or in range. 


$#name 

${#name} 
Gives the number of words in the variable. This is useful for 
later use in a [selector]. 


$0 Substitutes the name of the file from which command input is 
being read. An error occurs if the name is not known. 


$number 
${number} 
Equivalent to $argv[number]. 


$* Equivalent to $argv[*]. 


The modifiers :h, :t, :r, :q and :x may be applied to the substitu- 
tions above as may :gh, :gt and :gr. If braces { } appear in the 
command form then the modifiers must appear within the braces. 
Only one : modifier is allowed on each $ expansion. 


The following substitutions may not be modified with : modifiers. 
$?name 
${?name} 


Substitutes the string 1 if name is set, O if it is not. 


$?0 Substitutes 1 if the current input filename is known, 0 if it is 
not. 


$$ Substitutes the (decimal) process number of the (parent) shell. 
Command and Filename Substitution 

Command and filename substitution are applied selectively to the 
arguments of built-in commands. This means that portions of 
expressions which are not evaluated are not subjected to these 


expansions. For commands which are not internal to the shell, the 
command name is substituted separately from the argument list. 
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This occurs very late, after input-output redirection is performed, 
and in a child of the main shell. 


Command Substitution 


Command substitution is indicated by a command enclosed in back 
quotation marks. The output from such a command is normally 
broken into separate words at blanks, tabs and newlines, with null 
words being discarded, this text then replacing the original string. 
Within double quotation marks, only newlines force new words; 
blanks and tabs are preserved. 


In any case, the single final newline does not force a new word. 
Note that it is possible for a command substitution to yield only 
part of a word, even if the command outputs a complete line. 


Filename Substitution 


If a word contains any of the characters *, ?, [ or { or begins with 
the character ~, then that word is a candidate for filename substitu- 
tion, also known as globbing. This word is then regarded as a pat- 
tern, and replaced with an alphabetically sorted list of filenames 
which match the pattern. In a list of words specifying filename sub- 
stitution it is an error for no pattern to match an existing filename, 
but it is not required for each pattern to match. Only the meta- 
characters *, ?, and [ imply pattern matching, the characters ~ and 
{ being more akin to abbreviations. 


In matching filenames, the character . at the beginning of a 
filename or immediately following a /, as well as the character / 
must be matched explicitly. The character * matches any string of 
characters, including the null string. The character ? matches any 
single character. The sequence [...] matches any one of the charac- 
ters enclosed. Within [...], a pair of characters separated by - 
matches any character lexically between the two. 


The character ~ at the beginning of a filename is used to refer to 
home directories. Standing alone, it expands to the invoker’s home 
directory as reflected in the value of the variable home. When fol- 
lowed by a name consisting of letters, digits and - characters the 
shell searches for a user with that name and substitutes their home 
directory; thus “ken might expand to /usr/ken and “ken/chmach to 
/usr/ken/chmach. If the character ~ is followed by a character 
other than a letter or / or appears not at the beginning of a word, it 
is left unchanged. 


The metanotation a{b,c,d}e is a shorthand for abe ace ade. Left 
to right order is preserved, with results of matches being sorted 
separately at a low level to preserve this order. This construct may 
be nested. Thus ~source/s1/{oldls,1ls}.c expands to 
/usr/source/s1/oldls.c /usr/source/s1/ls.c, whether or not these files 
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exist, without any chance of error if the home directory for source 
is /usr/source. Similarly ../{memo,*box} might expand to ../memo 
../box ../mbox. (Note that memo was not sorted with the results of 
matching *box.) As a special case {, } and {} are passed 
unchanged. 


Input/Output 


The standard input and standard output of a command may be 
redirected with the following syntax: 


< name 
Opens file name (which is first variable, command and 
filename expanded) as the standard input. 


<< word 

Reads the shell input up to a line which is identical to word. 
Word is not subjected to variable, filename or command sub- 
stitution, and each input line is compared to word before any 
substitutions are done on this input line. Unless a quoting 
backslash, double, or single quotation mark, or a back quota- 
tion mark appears in word, variable and command substitu- 
tion is performed on the intervening lines, allowing \ to quote 
$, \ and ~. Commands which are substituted have all blanks, 
tabs, and newlines preserved, except for the final newline 
which is dropped. The resulting text is placed in an 
anonymous temporary file which is given to the command as 
standard input. 


> name 

>! name 

>& name 

> &! name 
The file name is used as standard output. If the file does not 
exist, then it is created; if the file exists, it is truncated, and 
its previous contents are lost. 


If the variable noclobber is set, then the file must not already 
exist or it must be a character special file (e.g., a terminal or 
/dev/null) or an error results. This helps prevent accidental 
destruction of files. In this case, the ! forms can be used and 
suppress this check. 


The forms involving & route the diagnostic output into the 


specified file as well as the standard output. Name is 
expanded in the same way as < input filenames are. 
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>> name 

>>& name 

>>! name 

>>&! name 
Uses file name as standard output like > but places output at 
the end of the file. If the variable noclobber is set, then it is 
an error for the file not to exist unless one of the ! forms is 
given. Otherwise similar to >. 


If a command is run detached (followed by &) then the default 
standard input for the command is the empty file /dev/null. Other- 
wise, the command receives the environment in which the shell was 
invoked as modified by the input-output parameters and the pres- 
ence of the command in a pipeline. Thus, unlike some previous 
shells, commands run from a file of shell commands have no access 
to the text of the commands by default; rather they receive the ori- 
ginal standard input of the shell. The << mechanism should be 
used to present inline data. This permits shell command scripts to 
function as components of pipelines and allows the shell to block 
read its input. 


Diagnostic output may be directed through a pipe with the standard 
output. Simply use the form | & rather than just |. 


Expressions 


A number of the built-in commands (to be described later) take 
expressions, in which the operators are similar to those of C, with 
the same precedence. These expressions appear in the @, exit, if, 
and while commands. The following operators are available: 


|| && | * == [= <= >= < > << >> 

ee does ae le ( 

Here the precedence increases to the right, == and !=, <=, >=, <, 
and >, << and >>, + and -, * / and % being, in groups, at the 
same level. The == and != operators compare their arguments as 
strings, all others operate on numbers. Strings which begin with 0 
are considered octal numbers. Null or missing arguments are con- 
sidered 0. The result of all expressions are strings, which represent 
decimal numbers. It is important to note that no two components 
of an expression can appear in the same word; except when adja- 
cent to components of expressions which are_ syntactically 
significant to the parser (& | < > ()) they should be surrounded by 
spaces. 


Also available in expressions as primitive operands are command 


executions enclosed in { and } and file enquines of the form -l 
name where | is one of: 
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Read access 
Write access 
Execute access 
Existence 
Ownership 
Zero size 

Plain file 
Directory 


AMmNOOM EA 


The specified name is command and filename expanded, then 
tested to see if it has the specified relationship to the real user. If 
the file does not exist or is inaccessible then all enquiries return 
false, i.e. 0. Command executions succeed, returning true, i.e. 1, if 
the command exits with status 0, otherwise they fail, returning 
false, i.e. O. If more detailed status information is required then 
the command should be executed outside of an expression and the 
variable status examined. 


Control Flow 


The shell contains a number of commands which can be used to 
regulate the flow of control in command files (shell scripts) and (in 
limited but useful ways) from terminal input. These commands all 
operate by forcing the shell to reread or skip in its input and, due 
to the implementation, restrict the placement of some of the com- 
mands. 


The foreach, switch, and while statements, as well as the if- 
then—else form of the if statement require that the major keywords 
appear in a single simple command on an input line as shown 
below. 


If the shell’s input is not seekable, the shell buffers up input when- 
ever a loop is being read and performs seeks in this internal buffer 
to accomplish the rereading implied by the loop. (To the extent 
that this allows, backward goto commands will succeed on non- 
seekable inputs. ) 


Built-In Commands 


Built-in commands are executed within the shell. If a built-in com- 
mand occurs as any component of a pipeline except the last, then it 
is executed in a subshell. 


alias 

alias name 

alias name wordlist 
The first form prints all aliases. The second form prints the 
alias for name . The final form assigns the specified wordlist as 
the alias of name; wordlist is command and filename substi- 
tuted. Name is not allowed to be alias or unalias 
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break 
Causes execution to resume after the end of the nearest 
enclosing foreach or while statement. The remaining com- 
mands on the current line are executed. Multilevel breaks are 
thus possible by writing them all on one line. 


breaksw 
Causes a break from a switch, resuming after the endsw. 


case label: 
A label in a switch statement as discussed below. 


cd 

cd name 

chdir 

chdir name 
Changes the shell’s working directory to directory name. If no 
argument is given, it then changes to the home directory of 
the user. If name is not found as a subdirectory of the 
current directory (and does not begin with /, ./, or ../), then 
each component of the variable cdpath is checked to see if it 
has a subdirectory name. Finally, if all else fails but name is a 
shell variable whose value begins with /, then this is tried to 
see if it is a directory. 

continue 
Continues execution of the nearest enclosing while or foreach. 
The rest of the commands on the current line are executed. 

default: 


Labels the default case in a switch statement. The default 
should come after all case labels. 


echo wordlist 
The specified words are written to the shell’s standard output. 
An \c causes the echo to complete without printing a newline. 
An \n in wordlist causes a newline to be printed. Otherwise 
the words are echoed, separated by spaces. 


else 

end 

endif 

endsw 
See the description of the foreach, if, switch, and while state- 
ments below. 


exec command 


The specified command is executed in place of the current 
shell. 
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exit 

exit(expr) 
The shell exits either with the value of the status variable (first 
form) or with the value of the specified expr (second form). 


foreach name (wordlist) 


end 
The variable name is successively set to each member of 
wordlist and the sequence of commands between this com- 
mand and the matching end are executed. (Both foreach and 
end must appear alone on separate lines.) 


The built-in command continue may be used to continue the 
loop prematurely and the built-in command break to terminate 
it prematurely. When this command is read from the termi- 
nal, the loop is read up once prompting with ? before any 
statements in the loop are executed. 


glob wordlist 
Like echo but no \ escapes are recognized and words are del- 
imited by null characters in the output. Useful for programs 
which wish to use the shell to filename expand a list of words. 


goto word 
The specified word is filename and command expanded to 
yield a string of the form label. The shell rewinds its input as 
much as possible and searches for a line of the form label: 
possibly preceded by blanks or tabs. Execution continues 
after the specified line. 


history 
Displays the history event list. 


if (expr) command 

If the specified expression evaluates true, then the single com- 
mand with arguments is executed. Variable substitution on 
command happens early, at the same time it does for the rest 
of the if command. Command must be a simple command, 
not a pipeline, a command list, or a parenthesized command 
list. Input/output redirection occurs even if expr is false, 
when command is not executed. 
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if (expr) then 
else if (expr2) then 
else 


endif 

If the specified expr is true then the commands to the first else 
are executed; else if expr2 is true then the commands to the 
second else are executed, etc. Any number of else-if pairs are 
possible; only one endif is needed. The else part is likewise 
optional. (The words else and endif must appear at the begin- 
ning of input lines; the jf must appear alone on its input line 
or after an else. ) 


logout : 
Terminates a login shell. The only way to log out if ignoreeof 
is set. 


nice 

nice +number 

nice command 

nice +number command 
The first form sets the nice for this shell to 4. The second 
form sets the nice to the given number. The final two forms 
run command at priority 4 and number respectively. The 
super-iser may specify negative niceness by using “nice 
-number ....”’ The command is always executed in a subshell, 
and the restrictions placed on commands in simple if state- 
ments apply. 


nohup 

nohup command 
The first form can be used in shell scripts to cause hangups to 
be ignored for the remainder of the script. The second form 
causes the specified command to be run with hangups 
ignored. Unless the shell is running detached, nohup has no 
effect. All processes detached with & are automatically 
nohuped. (Thus, nohup is not really needed.) 


onintr 

onintr - 

onintr label 
Controls the action of the shell on interrupts. The first form 
restores the default action of the shell on interrupts which is 
to terminate shell scripts or to return to the terminal com- 
mand input level. The second form onintr - causes all inter- 
rupts to be ignored. The final form causes the shell to exe- 
cute a goto label when an interrupt is received or a child pro- 
cess terminates because it was interrupted. 
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In any case, if the shell is running detached and interrupts are 
being ignored, all forms of onintr have no meaning and inter- 
rupts continue to be ignored by the shell and all invoked com- 
mands. 


rehash 

Causes the internal hash table of the contents of the direc- 
tories in the path variable to be recomputed. This is needed 
if new commands are added to directories in the path while 
you are logged in. This should only be necessary if you add 
commands to one of your own directories, or if a systems pro- 
grammer changes the contents of one of the system direc- 
tories. 


repeat count command 
The specified command which is subject to the same restric- 
tions as the command in the one line if statement above, is 
executed count times. I/O redirection occurs exactly once, 
even if count is 0. 


set 

set name 

set name=word 

set name[index]=word 

set name=(wordlist) 
The first form of the command shows the value of all shell 
variables. Variables which have other than a single word as 
value print as a parenthesized word list. The second form sets 
name to the null string. The third form sets name to the sin- 
gle word. The fourth form sets the indexth component of 
name to word; this component must already exist. The final 
form sets name to the list of words in wordlist. In all cases the 
value is command and filename expanded. 


These arguments may be repeated to set multiple values in a 
single set command. Note however, that variable expansion 
happens for all arguments before any setting occurs. 


setenv name value 
Sets the value of the environment variable name to be value, a 
single string. Useful environment variables are TERM, the 
type of your terminal and SHELL, the shell you are using. 


shift 

shift variable 
The members of argv are shifted to the left, discarding 
argv[1]. It is an error for argv not to be set or to have less 
than one word as value. The second form performs the same 
function on the specified variable. 
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source name 
The shell reads commands from name. Source commands may 
be nested; if they are nested too deeply, the shell may run out 
of file descriptors. An error in a source at any level ter- 
minates all nested source commands. Input during source 
commands is never placed on the history list. 


switch (string) 
case strl: 


breaksw 
default: 


breaksw 
endsw 

Each case label is successively matched, against the specified 
string which is first command and filename expanded. The 
file metacharacters *, ?, and [...] may be used in the case 
labels, which are variable expanded. If none of the labels 
match before a default label is found, then the execution 
begins after the default label. Each case label and the default 
label must appear at the beginning of a line. The command 
breaksw causes execution to continue after the endsw. Other- 
wise control may fall through case labels and default labels, as 
in C. If no label matches and there is no default, execution 
continues after the endsw. 


time 

time command 
With no argument, a summary of time used by this shell and 
its children is printed. If arguments are given, the specified 
simple command is timed and a time summary as described 
under the time variable is printed. If necessary, an extra shell 
is created to print the time statistic when the command com- 
pletes. 


umask 

umask value 
The file creation mask is displayed (first form) or set to the 
specified value (second form). The mask is given in octal. 
Common values for the mask are 002 giving all access to the 
group and read and execute access to others, or 022 giving all 
access except no write access for users in the group or others. 


unalias pattern 
All aliases whose names match the specified pattern are dis- 
carded. Thus, all aliases are removed by unalias *. It is not 
an error for nothing to be unaliased. 
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unhash 
Use of the internal hash table to speed location of executed 
programs is disabled. 


unset pattern 
All variables whose names match the specified pattern are 
removed. Thus, all variables are removed by unset *; this has 
noticeably distasteful side-effects. It is not an error for noth- 
ing to be unset. 


wait 
All child processes are waited for. It the shell is interactive, 
then an interrupt can disrupt the wait, at which time the shell 
prints names and process numbers of all children known to be 
outstanding. | 


while (expr) 


end 
While the specified expression evaluates nonzero, the com- 
mands between the while and the matching end are evaluated. 
Break and continue may be used to terminate or continue the 
loop prematurely. (The while and end must appear alone on 
their input lines.) Prompting occurs here the first time through 
the loop as for the foreach statement if the input is a terminal. 


@ 

@ name = expr 

@ name[index] = expr 
The first form prints the values of all the shell variables. The 
second form sets the specified name to the value of expr. If 
the expression contains <, >, & or | then at least this part of 
the expression must be placed within ( ). The third form 
assigns the value of expr to the indexth argument of name. 
Both name and its indexth component must already exist. 


The operators *=, +=, etc. are available as in C. The space 
separating the name from the assignment operator is optional. 
Spaces are mandatory in separating components of expr which 
would otherwise be single words. 


Special postfix ++ and — operators increment and decrement 
name respectively, i.e. @ i++. 


Predefined Variables 


The following variables have special meaning to the shell. Of 
these, argv, child, home, path, prompt, shell and status are always 
set by the shell. Except for child and Status this setting occurs only 
at initialization; these variables will not be modified unless done 
explicitly by the user. 
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The shell copies the environment variable PATH into the variable 
path, and copies the value back into the environment whenever 
path is set. Thus is is not necessary to worry about its setting other 
than in the file .cshrc as inferior csh processes will import the 
definition of path from the environment. 


argv 


cdpath 


child 


echo 


histchars 


history 


home 


ignoreeof 


mail 
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Set to the arguments to the shell, it is from this 
variable that positional parameters are substituted, 
i.e., $1 is replaced by $argyv[1], etc. 


Gives a list of alternate directories searched to find 
subdirectories in cd commands. 


The process number printed when the last com- 
mand was forked with &. This variable is unset 
when this process terminates. 


Set when the -x command line option is given. 
Causes each command and its arguments to be 
echoed just before it is executed. For nonbuilt-in 
commands all expansions occur before echoing. 
Builtin commands are echoed before command 
and filename substitution, since these substitutions 
are then done selectively. 


Can be assigned a two-character string. The first 
character is used as a history character in place of 
!, the second character is used in place of the * 
substitution mechanism. For’ example, _ set 
histchars=",;" will cause the history characters to 
be comma and semicolon. 


Can be given a numeric value to control the size of 
the history list. Any command which has been 
referenced in this many events will not be dis- 
carded. A history that is too large may run the 
shell out of memory. The last executed command 
is always saved on the history list. 


The home directory of the invoker, initialized from 
the environment. The filename expansion of ~ 
refers to this variable. 


If set, the shell ignores end-of-file from input dev- 
ices that are terminals. This prevents a shell from 
accidentally being terminated by pressing Ctrl-D. 


The files where the shell checks for mail. This is 
done after each command completion which will 
result in a prompt, if a specified interval has 
elapsed. The shell responds with, “You have new 
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noclobber 


noglob 


nonomatch 


path 


prompt 
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mail” if the file exists with an access time not 
greater than its modify time. 


If the first word of the value of mail is numeric, it 
specifies a different mail checking interval: in 
seconds, rather than the default, which is 10 
minutes. 


If multiple mail files are specified, then the shell 
responds with “New mail in name’, when there is 
mail in the file name. 


As described in the section Input/Output, restric- 
tions are placed on output redirection to insure 
that files are not accidentally destroyed, and that 
>> redirections refer to existing files. 


If set, filename expansion is inhibited. This is 
most useful in shell scripts which are not dealing 
with filenames, or after a list of filenames has been 
obtained and further expansions are not desirable. 


If set, it is not an error for a filename expansion to 
not match any existing files; rather, the primitive 
pattern is returned. It is still an error for the prim- 
itive pattern to be malformed, i.e., echo [ still gives 
an error. 


Each word of the path variable specifies a directory 
in which commands are to be sought for execution. 
A null word specifies the current directory. If 
there is no path variable, then only full pathnames 
will execute. The usual search path is /bin, 
/usr/bin, and ., but this may vary from system to 
system. For the super-user, the default search path 
is /etc, /bin and /usr/bin. A shell which is given 
neither the -c nor the -t option will normally hash 
the contents of the directories in the path variable 
after reading .cshrc, and each time the path vari- 
able is reset. If new commands are added to these 
directories while the shell is active, it may be 
necessary to give the rehash command, or the com- 
mands may not be found. 


The string which is printed before each command 
is read from an interactive terminal input. If a ! 
appears in the string, it will be replaced by the 
current event number unless a preceding \ is given. 
Default is % , or # for the super-user. 
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shell The file in which the shell resides. This is used in 
forking shells to interpret files which have execute 
bits set, but which are not executable by the sys- 
tem. (See the description of Nonbuilt-In Com- 
mand Execution below.) Initialized to the (system- 
dependent) home of the shell. 


status The status returned by the last command. If it ter- 
minated abnormally, then 0200 is added to the 
status. Built-in commands which fail return exit 
status 1, all other built-in commands set status 0. 


time Controls automatic timing of commands. If set, 
then any command which takes more than this 
many cpu seconds will cause a line giving user, sys- 
tem, real time, and a utilization percentage which 
is the ratio of user plus system times to real time to 
be printed when it terminates. 


verbose Set by the -v command line option, causes the 
words of each command to be printed after history 
substitution. 


Nonbuilt-In Command Execution 


When a command to be executed is found to not be a built-in com- 
mand, the shell attempts to execute the command via exec(S). 
Each word in the variable path names a directory from which the 
shell will attempt to execute the command. If it is given neither a 
-c nor a -t option, the shell will hash the names in these directories 
into an internal table so that it will only try an exec in a directory if 
there is a possibility that the command resides there. This greatly 
speeds command location when a large number of directories are 
present in the search path. If this mechanism has been turned off 
(via unhash), or if the shell was given a -e or -t argument, and in 
any case for each directory component of path which does not 
begin with a /, the shell concatenates with the given command 
name to form a pathname of a file which it then attempts to exe- 
cute. 


Parenthesized commands are always executed in a subshell. Thus 
(cd ; pwd) ; pwd prints the home directory; leaving you where you 
were (printing this after the home directory), while cd ; pwd leaves 
you in the home directory. Parenthesized commands are most 
often used to prevent cd from affecting the current shell. 


If the file has execute permissions but is not an executable binary to 


the system, then it is assumed to be a file containing shell com- 
mands and a new shell is spawned to read it. 


August 26, 1985 Page 20 


CSH (C) CSH (C) 


If there is an alias for shell then the words of the alias are 
prepended to the argument list to form the shell command. The 
first word of the alias should be the full pathname of the shell (e.g. 
$shell). Note that this is a special, late occurring, case of alias sub- 
stitution, and only allows words to be prepended to the argument 
list without modification. 


Argument List Processing 


If argument 0 to the shell is - then this is a login shell. The flag 
arguments are interpreted as follows: 


-c Commands are read from the (single) following argument 
which must be present. Any remaining arguments are placed 
in argv. 


-e The shell exits if any invoked command terminates abnor- 
mally or yields a nonzero exit status. 


-f |The shell will start faster, because it will neither search for 
nor execute commands from the file .cshrc in the invoker’s 
home directory. 


-i § The shell is interactive and prompts for its top-level input, 
even if it appears to not be a terminal. Shells are interactive 
without this option if their input and output are terminals. 


-n Commands are parsed, but not executed. This may aid in 
syntactic checking of shell scripts. 


-s Command input is taken from the standard input. 


-t A single line of input is read and executed. A \ may be used 
to escape the newline at the end of this line and continue 
onto another line. 


-v Causes the verbose variable to be set, with the effect that com- 
mand input is echoed after history substitution. 


-x Causes the echo variable to be set, so that commands are 
echoed immediately before execution. 


-V_ Causes the verbose variable to be set even before .cshrc is exe- 
cuted. 


-X Causes the echo variable to be set even before .cshrc is exe- 
cuted. 


After processing of flag arguments, if arguments remain but none 
of the -e, -i, -s, or -t options were given, the first argument is taken 
as the name of a file of commands to be executed. The shell opens 
this file, and saves its name for possible resubstitution by $0. On a 
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typical system, most shell scripts are written for the standard shell 
(see sh(C)), the C shell will execute such a standard shell if the first 
character of a script is not a # (i.e. if the script does not start with 
acomment). Remaining arguments initialize the variable argv. 


Signal Handling 


The shell normally ignores quit signals. The interrupt and quit sig- 
nals are ignored for an invoked command if the command is fol- 
lowed by &; otherwise the signals have the values which the shell 
inherited from its parent. The shells handling of interrupts can be 
controlled by onintr. Login shells catch the terminate signal; other- 
wise this signal is passed on to children from the state in the shell’s 
parent. In no case are interrupts allowed when a login shell is read- 
ing the file .logout. 


Files 
~/.cshre Read at by each shell at the beginning 
of execution 
/etc/cshre Systemwide default cshrc file if none is present 
“/.login Read by login shell, after .cshrc at login 
“/ logout Read by login shell, at logout 
/bin/sh Shell for scripts not starting with a # 
/tmp/sh* Temporary file for << 
/dev/null Source of empty file 
/etc/passwd Source of home directories for “name 
Limitations 


Words can be no longer than 512 characters. The number of argu- 
ments to a command which involves filename expansion is limited 
to 1/6 number of characters allowed in an argument list, which is 
5120, less the characters in the environment. Also, command sub- 
stitutions may substitute no more characters than are allowed in an 
argument list. 


To detect looping, the shell restricts the number of alias substitu- 
tions on a single line to 20. 
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See Also 
access(S), exec(S), fork(S), pipe(S), signal(S), umask(S), wait(S), 
a.out(F), environ(F) 

Credit 
This utility was developed at the University of California at Berke- 
ley and is used with permission. 

Notes 


Built-in control structure commands like foreach and while cannot 
be used with |, & or ;. 


Commands within loops, prompted for by ?, are not placed in the 
history list. 3 


It is not possible to use the colon (:) modifiers on the output of 
command substitutions. 


csh attempts to import and export the PATH variable for use with 
regular shell scripts. This only works for simple cases, where the 
PATH contains no command characters. 


This version of csh does not support or use the process control 
features of the 4th Berkeley Distribution. 
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Name 


csplit — Splits files according to context. 


Syntax 


csplit [—s] [—k] [-f prefix] file argl [. . . argn| 


Description 


Csplit reads file and separates it into n+1 sections, defined by the 
arguments arg]... argn. By default the sections are placed in 

... Xxm (n may not be greater than 99). These sections get 
the following pieces of file: 


00: From the start of file up to (but not including) the line refer- 
enced by argl. 


01: From the line referenced by arg] up to the line referenced 
by arg2. 


n+1: From the line referenced by argn to the end of file. 
The options to csplit are: 


=—s Csplit normally prints the character counts for each file 
created. If the —s option is present, csplit suppresses the 
printing of all character counts. 


-k Csplit normally removes created files if an error occurs. 
If the —k option is present, csplit leaves previously 
created files intact. 


—f prefix If the —f option is used, the created files are named 
prefix00 ... prefixn. The default is xx00 ... xxn. 


The arguments (arg] ... argn) to csplit can be a combination of 
the following: 


/rexp! A file is to be created for the section from the current line 
up to (but not including) the line containing the regular 
expression rexp. The current line becomes the line con- 
taining rexp. This argument may be followed by an 
optional tor — some number of lines (e.g., /Page/—5). 


%rexp Yo 


This argument is the same as /rexp/, except that no file is 
created for the section. 
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Inno A file is to be created from the current line up to (but not 
including) /nno. The current line becomes Jnno. 


{num} Repeat argument. This argument may follow any of the 
above arguments. If it follows a rexp type argument, that 
argument is applied num more times. If it follows Inno, 
the file will be split every /nno lines (num times) from that 
point. 


Enclose all rexp type arguments that contain blanks or other char- 
acters meaningful to the shell in the appropriate quotation marks. 
Regular expressions may not contain embedded newlines. Csplit 


does not affect the orginal file; it is the users responsibility to 
remove it. 


Examples 


csplit -f cobol file '/procedure division/’ /par5S./ /par16./ 


This example creates four files, cobol00 ... cobol03. After edit- 
ing the “‘split” files, they can be recombined as follows: 


cat cobol0[0—-3] > file 
Note that this example overwrites the original file. 

csplit —-k file 100 {99} 
This example would split the file at every 100 lines, up to 10,000 
lines. —The —k option causes the created files to be retained if there 
are less than 10,000 lines; however, an error message would still be 
printed. 

csplit -k prog.c ‘%main(%’' ‘/*}/+1' {20} 
Assuming that prog.c follows the normal C coding convention of 
ending routines with a } at the beginning of the line, this example 
will create a file containing each separate C routine (up to 21) in 
prog.c. 


See Also 
ed(C), sh(C), regex(S) 
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Diagnostics 
Self-explanatory except for: 
arg — out of range 


which means that the given argument did not reference a line 
aor between the current position and the end of the file. 
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Name 


cu — Calls another XENIX system. 


Syntax 
cu [ -sspeed | [-aacu ] [-lline ] [-h] [-o -e] telno 
cu [ -sspeed ] [ -line ] [-h] [-o| -e] dir 


Description 


Cu “calls up” another XENIX system through a modem or a direct 
serial connection. It also controls the transmission and reception 
of data and programs during the call. Cu looks at each line in the 
file /usr/lib/uucp/L-devices until it finds a line that matches the 
options given in the command line. If it finds an appropriate line, it 
will attempt to make a connection. If it cannot find the proper line, 
cu quits. 


The options are: 


—sspeed 
Specifies the transmission speed. 1200 baud is the default value. 
Other speeds available are 110, 150, 300, 1200, 2400, 4800 and 
9600 baud. Directly connected lines may be set to other speeds. 
Most modems are restricted to 300 and 1200 baud. : 


—aacu 
Specifies the device name of the ACU (automatic calling unit) 
device. If not specified, cu will use the first available acu with 
the right speed. 


line 
Specifies the device name of the communications line. If not 
specified, cu will use the first available direct line (if dir is 
specified) or acu (if a telno is specified) with the right speed. 


—h 
Emulates local echo. This feature supports calls to systems that 
expect half-duplex mode terminals. 


—e 
Specifies that even-parity data is to be generated for data sent to 
the remote system. 


=O 


Specifies that odd-parity data is to be generated for data sent to 
the remote system. 
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Telno is the telephone number of the remote system. 


For acu connections, cu invokes /usr/lib/uucp/dial to dial the 
modem. Consult your modem manual to determine the correct 
sequences to include in the phone number for pauses, pulse dialing, 
etc. 


For directly connected lines, the string “dir” is used instead of 


telno. See the Examples later in this section for sample command 
lines. 


After making the connection, cu runs as two processes: transmit 
and receive. The transmit process reads data from the standard 
input and, except for lines beginning with a tilde (~), passes it’ to 
the remote system. The receive process accepts data from the 
remote system and, except for lines beginning with a tilde, passes it 
to the standard output. Normally, an automatic KON/XOFF 
(DC3/DC1) protocol controls input from the remote system so the 
buffer is not overrun. Lines beginning with a tilde have special 
meanings. 


The transmit process interprets lines beginning with a tilde as fol- 
lows: 


Terminates the conversation. 

ae ; Escapes to an interactive shell on the local 
system. 

“tomd... Runs cmd on the local system (via sh -c). 

“$cmd... Runs cmd locally and sends its output to the 


remote system. 


“%take remote [ local | 

Copies file remote (on the remote system) to 
file local on the local system. If local is 
omitted, the remote filename is used in both 
places. Use of this line requires the existence 
of echo(C) and cat(C) on the remote system. 
If tabs are to be copied without expansion, 
stty tabs mode should be set on the remote 
system. 


“Yo put local [| remote | , 
Copies file local (on the local system) to file 
remote on the remote system. If local is 
omitted, the remote filename is used in both 
places. Use of this line requires the existence 
of stty (C) and cat (C) on the remote system. 
It also requires that the current erase and kill 
characters on the remote system be identical 
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to the current ones on the local system. 
Backslashes are inserted at appropriate 


places. 
“%b or ~% break Sends a break char to the remote system. 
ee Sends the line ~... to the remote system. 
~%nostop Turns off the XON/XOFF input control proto- 


col for the remainder of the session. This is 
useful if the remote system is one which does 
not respond properly to the XON/XOFF char- 
acters. 


The receive process normally copies data from the remote system to 
its standard output. A line from the remote system that begins with 
“> diverts the output to a file. Data is appended to a file if “>> is 
used. The diversion is terminated by a trailing “>. The complete 
sequence Is: 


“>[> ]: file 
zero or more lines to be written to file 
> 
Examples 
A sample command for a dialup connection is: 


cu 5559801 


Cu will select the first available acu at the default speed of 1200 
baud. 


A sample command for a direct connection is: 
cu dir 


Cu will select the first available direct line at the default speed of 
1200 baud. 


You can force cu to use a specific acu device, line device or speed 
with the command line options -a, -l and -s. This is useful if you 
wish to use the same modem for dialup connections at both 300 
and 1200 baud, or if you have more than one directly connected 
computer. For example: 


cu -a tty12 -s 300 5559801 
will force cu to place the call through /dev/tty12 at 300 baud. 
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cu -1 tty12 dir 


will cause /dev/tty12 to be used for a direct connection at 1200 
baud. 


Files 
/usr/lib/uucp/L-devices Device information 
/usr/lib/uucp/dial Dialer program 

See Also 


cat(C), echo(C), stty(C), tty(M) 
Diagnostics 


Exit code is zero for normal exit, nonzero (various values) other- 


Device busy: Someone else is using the desired line. 


Notes 


There *« an artificial slowing of transmission by cu during the “%put 
operation so that loss of data is unlikely. 


ASCII files only can be transferred using “%take or “%put; binary 
files cannot be transferred. 


Cu opens devices for exclusive use. If cu terminates abnormally, 
the device may remain locked. 
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Name 


custom — Installs specific portions of the XENIX System 


Syntax 
custom [-odt] [-irl [package]] [-f [file]] 


Description 
With custom you can create a custom installation by selectively 
installing or deleting portions of the XENIX system. custom is exe- 
cutable only by the super—user and is either interactive or can be 
invoked from the command line with several options. 


Files are extracted or deleted in packages. A package is a collec— 
tion of individual files. Packages are grouped together in sets. 


The sets are: 

Operating System 

Development System 

Text Processing System 
You can list the available packages by using the custom command 
as described next. 

Usage 

To use custom interactively, enter: 
| custom 
You see a list of sets. For example: 

1. Operating System 

2. Development System 

3. Text Processing System 
The program prompts you to choose a set from which to work. If 
the data files for that set are not already installed on the hard disk, 
custom prompts you for the floppy which contains these data files 
and installs them. When you select a valid set, you see a menu like 
this: 


1. Install one or more packages 
2. Remove one or more packages 
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List the files in a package 
Install a single file 

Select a new set to customize 
Display current disk usage 
Help 


Se ie 


When you enter a menu option, you are prompted for further infor- 
mation. This is what the options prompt, and what action occurs: 


1. Install 
Prompts for one or more package names. 


Calculates which installation volumes (distribution media) are 
needed, then prompts for the correct volume numbers. If multi- 
ple packages are specified, the names should be separated by 
spaces on the command line. 


This option, as well as “2” and “3,” displays a list of all available 
packages in the currently selected set. Each line describes the 
package name, whether the package is fully installed, not installed 
or partially installed, the size of the package (in blocks), and a one 
line description of the package contents. 


2. Remove 
Prompts for one or more package names. 


Deletes the correct files in the specified package. If multiple 
packages are specified the names should be separated by spaces 
on the command line. 


Displays available packages (see option “‘1”’). 


3. List files in a package 
Lists all files in the specified package. 


Prompts for one or more package names. Enter the name of 
the desired package(s). 


Displays available packages (see option ‘‘1’’). 


4. Install a single file 
Extract the specified file from the distribution set. 


Filename should be a full pathname relative to the root directory 
at be 


5. Select a new set 


Allows you to work from a different set than the current one. 
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6. Display current disk usage 
Tells you your current disk usage. 
7. Help 
Prints a page of instructions to help you use custom. 
Options 


Three arguments are required for a completely non-interactive use 
of custom: 


A set identifier (—o, —d, or -t), 
A command (-i, -r, —l, or —f), 
And either one or more package names, or a file name 


If any information is missing from the command line, custom 
prompts for the missing data. 


Only one of -o, —d, or -t may be specified. These stand for: 
-—o Operating System 
-d Development System 
-t Text Processing System 
Only one of —i, —-r, -1, or -f may be specified, followed by an argu- 
ment of the appropriate type (one or more package names, or a file 
name). These options perform the following: 
-i Install the specified package(s) 
-r Remove the specified package(s) 
-] List the files in the specified package(s). 
-f Install the specified file. 
Files 
/etc/base.perms 
/etc/soft.perms 
/etc/text.perms 
See Also 


fixperm(M), df(C), du(C), install(C) 
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Notes 


If you upgradé ‘any part of your system, custom detects if you have 
a different release and prompts you to insert the floppy volume that 
updates the custom data files. 
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Name 


date — Prints and sets the date. 


Syntax 
date [ mmddhhmn[yy] | [ +format | 


Description 


If no argument is given, or if the argument begins with +, the 
current date and time are printed. Otherwise, the current date is 
set. The first mm is the month number; dd is the day number in 
the month; AA is the hour number (24-hour system); the second 
mm is the minute number; yy is the last 2 digits of the year number 
and is optional. For example: 


date 10080045 


sets the date to Oct 8, 12:45 AM. The current year is the default if 
no year is mentioned. The system operates in GMT. Date takes 
care of the conversion to and from local standard and daylight 
time. ) 

If the argument begins with +, the output of date is under the con- 
trol of the user. The format for the output is similar to that of the 
first argument to printf (S). All output fields are of fixed size (zero 
padded if necessary). Each field descriptor is preceded by a per- 
cent sign (%) and will be replaced in the output by its correspond- 
ing value. A single percent sign is encoded by doubling the percent 
sign, i.e., by specifying ““%%”. All other characters are copied to 
the output without change. The string is always terminated with a 
newline character. 


Field Descriptors: 

n Inserts a newline character 

t Inserts a tab character 

m Month of year — 01 to 12 

d Day of month — 01 to 31 

y Last 2 digits of year — 00 to 99 
D Date as mm/dd/yy 
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Hour — 00 to 23 
Minute — 00 to 59 
Second — 00 to 59 


Hnz ye 


Time as HH:MM:SS 

j Julian date — 001 to 366 

w Day of the week — Sunday = 0 

a Abbreviated weekday — Sun to Sat 
h Abbreviated month - Jan to Dec 


r Time in AM/PM notation 


Example 
The line 
date ‘+DATE: %m/%d/%y%nTIME: %H:%M:% S$! 
generates as output: 


DATE: 08/01/76 
TIME: 14:45:05 


Diagnostics 
no permission You aren’t the super-user and you are trying 
to change the date. 
bad conversion The date set is syntactically incorrect. 


bad format character The field descriptor is not recognizable. 
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Name 


dc — Invokes an arbitrary precision calculator. 


Syntax 


dc [ file ] 


Description 


Dc is an arbitrary precision arithmetic package. Ordinarily it 
operates on decimal integers, but you may specify an input base, 
output base, and a number of fractional digits to be maintained. 
The overall structure of dc is a stacking (reverse Polish) calculator. 
If an argument is given, input is taken from that file until its end, 
then from the standard input. The following constructions are 
recognized: 


number 
The value of the number is pushed on the stack. A number 
is an unbroken string of the digits 0-9. It may be preceded 
by an underscore (_) to input a negative number. Numbers 
may contain decimal points. 


+—-/*%~ 
The top two values on the stack are added (+), subtracted 
(—), multiplied (*), divided (/), remaindered (%), or 
exponentiated (*). The two entries are popped off the stack; 
the result is pushed on the stack in their place. Any frac- 
tional part of an exponent is ignored. 


SX The top of the stack is popped and stored into a register 
named x, where x may be any character. If the s is capital- 
ized, x is treated as a stack and the value is pushed on it. 


lx The value in register x is pushed on the stack. The register x 
is not altered. All registers start with zero value. If the I is 
capitalized, register x is treated as a stack and its top value is 
popped onto the main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top value remains 
unchanged. p interprets the top of the stack as an ASCII 


string, removes it, and prints it. 


f All values on the stack are printed. 
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X 


DC (C) 


Exits the program. If executing a string, the recursion level 
is popped by two. If q is capitalized, the top value on the 
stack is popped and the string execution level is popped by 
that value. 


Treats the top element of the stack as a character string and 
executes it as a string of dc commands. 


Replaces the number on the top of the stack with its scale . 
factor. 


[ ... ] Puts the bracketed ASCII string onto the top of the stack. 


<X PX =X 


a) 


The top two elements of the stack are popped and com- 
pared. Register x is evaluated if they obey the stated rela- 
tion. 


Replaces the top element on the stack by its square root. 
Any existing fractional part of the argument is taken into 
account, but otherwise the scale factor is ignored. 

Interprets the rest of the line as a XENIX command. 

All values on the stack are popped. 


The top value on the stack is popped and used as the 
number radix for further input. 


Pushes the input base on the top of the stack. 


The top value on the stack is popped and used as the 
number radix for further output. 


Pushes the output base on the top of the stack. 


The top of the stack is popped, and that value is used as a 
nonnegative scale factor; the appropriate number of places 
are printed on output, and maintained during multiplication, 
division, and exponentiation. The interaction of scale fac- 
tor, input base, and output base will be reasonable if all are 
changed together. 


The stack level is pushed onto the stack. 
Replaces the number on the top of the stack with its length. 


A line of input is taken from the input source (usually the 
terminal) and executed. 
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a Used by bc for array operations. 


Example 


This example prints the first ten values of n!: 


[lal+dsa*plal0>y]sy 
Osal 
lyx 
See Also 
bc(C) 
Diagnostics 
x is unimplemented The octal number x corresponds to a char- 
acter that is not implemented as a com- 
mand 
stack empty Not enough elements on the stack to do 
what was asked 
Out of space The free list is exhausted (too many digits) 
Out of headers Too many numbers being kept around 
Out of pushdown Too many items on the stack 
Nesting Depth Too many levels of nested execution 
Notes 


Bc is a preprocessor for dc, providing infix notation and a C-like 
syntax which implements functions and reasonable control struc- 
tures for programs. For interactive use, bc is preferred to dc. 
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Name 


DD (C) 


dd — Converts and copies a file. 


Syntax 


dd [option=value] ... 


Description 


Dd copies the specified input file to the specified output with possi- 


ble conversions. 


The standard input and output are used by 


default. The input and output block size may be specified to take 
advantage of raw physical I/O. 


Option 
if=file 
of=file 


ibs=n 


obs=n 


bs=n 


cbs=n 
skip=n 


seek=n 


count=n 
conv=ascii 
conv=ebcdic 
conv=ibm 


conv=lIcase 
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Value 
Input filename; standard input is default 
Output filename; standard output is default 


Input block size n bytes (default is BSIZE block 
size) 


Output block size (default is BSIZE block size) 
Sets both input and output block size, supersed- 
ing ibs and obs; also, if no conversion is 
specified, it is particularly efficient since no in- 
core copy needs to be done 

Conversion buffer size 


Skips 1 input records before starting copy 


Seeks n records from beginning of output file 
before copying 


Copies only n input records 
Converts EBCDIC to ASCII 
Converts ASCII to EBCDIC 
Slightly different map of ASCII to EBCDIC © 


Maps alphabetics to lowercase Option Value 
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conv=ucase Maps alphabetics to uppercase 
conv=swab Swaps every pair of bytes 
conv=sync Pads every input record to ibs 


— *? ee . 
conv= ...,... Several comma-separated conversions 


Where sizes are specified, a number of bytes is expected. A 
number may end with k, b, or w to specify multiplication by 1024, 
512, or 2 respectively; a pair of numbers may be separated by x to 
indicate a product. 

Cbs is used only if ascii or ebcdic conversion is specified. In the 
former case cbs characters are placed into the conversion buffer, 
converted to ASCII, and trailing blanks trimmed and newline added 
before sending the line to the output. In the latter case ASCII 
characters are read into the conversion buffer, converted to 
EBCDIC, and blanks added to make up an output record of size 
cbs. 


After completion, dd reports the number of whole and partial 
input and output blocks. : 
Examples 


This command reads an EBCDIC tape, blocked ten 80-byte 
EBCDIC card images per record, into the ASCII file outfile : 


dd if=/dev/rmtO of=outfile ibs=800 cbs=80 conv=ascii,lcase 
Note the use of raw magtape. Dd is especially suited to /O on raw 


physical devices because it allows reading and writing in arbitrary 
record sizes. 


See Also 
copy(C), cp(C), tar(C) 


Diagnostics 


f+p records in(out) Numbers of full and partial records 
read(written) 
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Notes 


The ASCU/EBCDIC conversion tables are taken from the 256- 
character standard in the CACM Nov, 1968. The ibm conversion 
corresponds better to certain IBM print train conventions. There is 
no universal solution. 


Newlines are inserted only on conversion to ASCII; padding is done 
only on conversion to EBCDIC. | 
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Name 


devnm — Identifies device name. 


Syntax 


/etc/devnm [ names | 


Description 


Devnm identifies the special file associated with the mounted file 
system where the argument name resides. 


This command is most commonly used by /etc/re to construct a 
mount table entry for the root device. 
Examples 
Be sure to type full pathnames in this example: 
/etc/devnm /usr 
If /dev/hd1 is mounted on /usr, this produces: 


hdl /usr 


Files 
/dev/* Device names 


/etc/rc Xenix startup commands 


See Also 


setmnt(C) 


August 26, 1985 Page 1 


DF (C) DF (C) 
Name 


df — Report number of free disk blocks. 


Syntax 


df [ —t ][ —f][—v —i | [ file-systems | 


Description 


Df prints out the number of free blocks and free inodes available 
for on-line file systems by examining the counts kept in the super— 
blocks; file—systems may be specified by device name (e.g., 
/dev/root). If the file—systems argument is unspecified, the free 
space on all of the mounted file systems is sent to the standard out- 
put. The list of mounted file systems is given in /etc/mnttab. 


Options include: 


—t Causes total allocated block figures to be reported as well as 
number of free blocks. 


-f Reports only an actual count of the blocks in the free list 
(free inodes are not reported). With this option, df reports 
on raw devices. 


-—v Reports the percent of blocks used as well as the number of 
blocks used and free. : 


—i Reports the percent of inodes used as well as the number of 
inodes used and free. Use the —i option with the —v option 
to display counts of blocks and inodes free as well as the per— 
centage of inodes and blocks used. : 


The —v and —i options can not be used with other df options. 


Files 


/dev/* 
/etc/mnttab 


See Also 
fsck(C), mount(C), mnttab(F) 
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Notes 
See Notes under mount(C). 


This utility reports sizes in 512 byte blocks. On systems which use 
1024 byte blocks, this means a file of 500 bytes uses 2 blocks. df 
will report 2 blocks less free space, rather than 1 block, since the 
file uses one system block of 1024 bytes. Refer to the machine(M) 
manual page for the block size used by your system. 
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Name 


diff - Compares two text files. 


Syntax 


diff | —efbh | file1 file2 


Description 


Diff tells what lines must be changed in two files to bring them into 
agreement. If filel (file2) is —, the standard input is used. If file/ 
(file2) is a directory, then a file in that directory with the name file2 
(filel) is used. The normal output contains lines of these forms: 


nl a n3,n4 
nl,n2 d n3 
nl,n2 ¢ n3,n4 


These lines resemble ed commands to convert file into file2. The 
numbers after the letters pertain to file2. In fact, by exchanging a 
for d and reading backward, one may ascertain equally how to con- 
vert file2 into filel. As in ed, identical pairs where nl = n2 or n3 = 
n4 are abbreviated as a single number. 


Following each of these lines come all the lines that are affected in 
the first file flagged by <, then all the lines that are affected in the 
second file flagged by >. 


The —b option causes trailing blanks (spaces and tabs) to be 
ignored and other strings of blanks to compare equal. 


The —e option produces a script of a, c and d commands for the 
editor ed, which will recreate file2 from file]. The —f option pro- 
duces a similar script, not useful with ed, in the opposite order. In 
connection with —e, the following shell procedure helps maintain 
multiple versions of a file: 


(shift; cat $*; echo '1,$p’) | ed — $1 


This works by performing a set of editing operations on an original 
ancestral file. This is done by combining the sequence of ed scripts 
given as all command line arguments except the first. These scripts 
are presumed to have been created with diff in the order given on 
the command line. The set of editing operations is then piped as 
an editing script to ed where all editing operations are performed 
on the ancestral file given as the first argument on the command 
line. The final version of the file is then printed on the standard 
output. Only an ancestral file ($1) and a chain of version-to-version 
ed scripts ($2,$3,...) made by diff need be on hand. 


August 26, 1985 Page 1 


DIFF (C) DIFF (C) 


Except in rare circumstances, diff finds the smallest sufficient set of 
file differences. 


The —h option does a fast, less-rigorous job. It works only when 
changed stretches are short and well separated, but also works on 
files of unlimited length. The -e and —f cannot be used with the 
—h option. 


Files 


/usr/lib/diffh for —h 


See Also 
cmp(C), comm(C), ed(C) 


Diagnostics 
Exit status is 0 for no differences, 1 for some differences, 2 for 
errors. 

Notes 


Editing scripts produced under the —e or —f option do not always 
work correctly on lines consisting of a single period (.). 
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Name 


diff3 - Compares three files. 


Syntax 
diff3 [ —ex3 | file1 file2 file3 


Description 


Diff3 compares three versions of a file, and publishes disagreeing 
ranges of text flagged with these codes: 


ee All three files differ 


====] Filel is different 
====72 File2 is different 
====3 File3 is different 


The type of change suffered in converting a given range of a given 
file to some other range is indicated in one of these ways: 


finla Text is to be appended after line number n/J in 
file f, where f = 1, 2, or 3. 


fT fat] ghee Text is to be changed in the range line nJ to 
line n2. If nl = n2, the range may be abbrevi- 
ated to nl. 


The original contents of the range follows immediately after ac 
indication. When the contents of two files are identical, the con- 
tents of the lower-numbered file is suppressed. 


Under the —e option, diff3 publishes a script for the editor ed that 
will incorporate into file] all changes between file2 and files, 16:, 
the changes that normally would be flagged ==== and ====3, The 
—x option produces a script to incorporate changes flagged with 
“=<===”, Similarly, the —3 option produces a script to incorporate 
changes flagged with “====3”. The following command applies a 
resulting editing script to filel: 


(cat script; echo '1,$p’) | ed — file1 
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/tmp/d3* 
/usr/lib/diff3prog 


See Also a, 
diff(C) 


Notes 


The —e option does not work properly for lines consisting of a sin- 
gle period. 


The input file size limit is 64K bytes. 
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Name 


diremp — Compares directories. 


Syntax 


diremp [ —d ][ —s ] [ —wa ] dirl dir2 


Description 
Dircmp examines dirl and dir2 and generates tabulated information 
about the contents of the directories. Listings of files that are 
unique to each directory are generated in addition to a list that indi- 
cates whether the files common to both directories have the same 
contents. 
There are three options available: 


—d Performs a full diff on each pair of like-named files if the 
contents of the files are not identical. 


—S Reports whether the files are “same”’ or “different”. 
—wn Changes the width of the output line to n characters. The 
default width is 72. 
See Also 
cmp(C), diff(C). 
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Name 


dirname — Delivers directory part of pathname. 


Syntax 
dirname string 

Description 
Dirname delivers all but the last component of the pathname in 
string and prints the result on the standard output. If there is only 
One component in the pathname, only a “dot” is printed. It is nor- 
mally used inside substitution marks (**) within shell procedures. 
The companion command basename deletes any prefix ending in a 
slash (/) and the suffix (if present in string) from String, and prints 
the result on the standard output. 

Examples 
The following example sets the shell variable NAME to 
/usr/src/cmd: 

— NAME=“dirname /usr/src/cmd/cat.c* 


This example prints /a/b/c on the standard output: 
dirname /a/b/c/d 
This example prints a “‘dot” on the standard output: 


dirname file.ext 


See Also 


basename(C), sh(C) 
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Name 


disable — Turns off terminals and printers. 


Syntax 
disable tty ... 
disable [-c][-r[reason]] printers 
Description 
For terminals, this program manipulates the /etc/ttys file and signals 
init to disallow logins on a particular terminal. For printers, disable 
stops print requests from being sent to the named printer. The fol- 
lowing options can be used: 
Cc Cancels any requests that are currently printing. 
—r[reason| Associates a reason with disabling the printer. The 
reason applies to all printers listed up to the next —r 
option. If the —r option is not present or the —r 
option is given without a reason, then a default reason 
is used. Reason is reported by Ipstat(C). 


Examples 


In this example, a printer named linepr is disabled because of a 
paper jam: 


disable -r" paper jam" linepr 


Files 
/dev/tty* 
/etc/ttys 


/usr/spool/lp/* 
See Also 


login(M), enable(C), ttys(M), getty(M), init(M), Ip(C), Ipinit(C), 
Ipstat(C) 
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Warning 


Be absolutely certain to pause at least one minute before reusing 
this command or before using the enable command. Failure to do 
so may cause the system to crash. 
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Name 


diskcp, diskcmp — Copies or compares floppy disks. 


Syntax 


diskcp [ -f ] [ -d | 
diskcmp [ -f | [ -d | 


Description 


This command provides easy copying of a source floppy disk. dd is 
used to make an image of the source floppy (the one you wish to 
copy). On machines with one floppy drive diskep temporarily 
transfers the image to the hard disk until a blank “‘target” floppy is 
inserted into the floppy drive. On machines with two floppy drives 
dd immediately places the image of the source floppy directly on 
the target floppy. 


The options are: 
-f Format the target floppy disk before the image is copied. 


-d The computer has dual floppy drives. diskcp copies the image 
directly onto the target floppy. 


diskemp functions similarly to diskep. It compares the contents of 
one floppy disk with the contents of a second floppy disk using the 
cmp utility. The syntax is the same as that of diskep. 


Examples 


To make a copy of a floppy, place the source floppy in the drive 
and type: 


diskcp 
When diskep is finished copying to the hard disk, it prompts you to 
insert the target floppy in the drive. If you specify the -f flag, diskep 
will format the disk. When the copy is finished, diskep asks if you 


would like to make another copy of the same source disk. When 
you answer ‘n’ it asks if you would like to copy another source disk. 


Specify the -d flag on the command line if you have two floppy 
drives. 


diskcp -d 
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Notes 
If diskcp encounters a write error while copying the source image 
to the target disk, it will format the disk and try again. This hap- 
pens most often when an unformatted floppy is used and the -f flag 
is not specified. 
diskcp reads and writes to 48 tpi, double sided, 9 sector per track 


floppies (/dev/fd048ds9). The diskcp shell script can be edited to 
support other types of backup media. 


Files 
/usr/bin/diskcp 
/usr/bin/diskcmp 
/tmp/disk$$ 

See Also 


dd(C), cmp(C) 
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Name 


divvy — Disk dividing utility 


Syntax 
divvy —b block_device -c character_device [—v virtual_drive] 
[-p physical_drive] [-i [proto]] 

Description 
divvy divides a disk or fdisk(C) partition into a number of separate 
areas, also known as “devices” or “divisions.” A division is identi- 
fied by unique major and minor device numbers and can be used 
for file systems, swap areas, and isolating bad spots on the disk. 
With divvy you can: 
— Divide a disk or fdisk partition into separate devices. 
— Create new file systems. 
- Change the device names of file systems. 
— Change the size of file systems. 
- Remove file systems. 

Options 
Options to divvy are: 


—b block_device 
Major device number of block interface. 


-—c character_device 
Major device number of character interface. 


-v virtual_device 
For dividing a virtual drive. 


—p physical_drive 
For dividing one of several physical disks that share the same 
controller. 


—i [proto] 
Disk being divided will contain a root file system. 
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Usage 


During XENIX installation, divvy prompts for the size of the swap 
area. Pressing RETURN selects a calculated “default” value. If the 
disk is large enough, divvy prompts for a separate /u (user) file sys— 
tem. 


divvy may also prompt for block by block control over the layout of 
the file system or file systems. With block by block control, you 
can use divvy interactively to choose the exact layout of a particular 
disk or file system. 


The device being divided must be a block device with a character 
interface. For example, to use divvy on a device with a block inter— 
face major number 1 and character interface number of 1, enter: 


divvy —b 1 -c 1 


‘The —v option specifies which virtual drive to divide. The default 
is the active drive. Here, “‘virtual drive” is the same as an MS-DOS 
partition. Virtual drive numbers are determined with the fdisk(C) 
utility. 


The —p option allows division of one of several physical disks shar— 
ing a controller. divvy defaults to the first physical device num— 
bered “0.” To access a second physical disk, use the —p 1 option. 


The —i option specifies the device being divided will contain a root 
file system. With this option, device nodes are created relative to 
the new root, generally a hard disk, instead of the current root , 
often an installation floppy. If the name of a proto file is given 
after the —i option, a copy of this proto file is modified to fit the 
new file system, and passed to mkfs(C) when the new root file sys— 
tem is created. See mkfs(C) for information on proto files. 


When divvy is invoked from the command line, you see a main 
menu: 


d[isplay] Display the divvy table. . 

b[lock] Change the name of a division’s block interface. 
c{haracter] | Change the name of a division’s character device. 
o[verwrite] | Overwrite a division with a new file system. 


prevent] Prevent a division from being overwritten. 
s[tart] Start a division on a new block. 

e[nd] End a division on a new block. 

t[rade] Trade the blocks two divisions refer to. 
r[estore] Restore default root partition table. 


Please enter your choice or ‘q’ to quit: 
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To choose a command, enter the first letter of the command, then 
press RETURN. For example, to display the current division table, 
enter ‘d’. 


The divvy division table might look something like this: 
ae ee ee 
Partition Partition corer Block 
root rroot no, exists 


swap rswap no, exists 
u ru no, exists 


recover rrecover no, exists 
no 
no 
no 
no 


When pertinent, divvy also displays information about block alloca— 
tion for bad tracks. 


If you select option ‘b’, you can change the name of a block divi-— 
sion. divvy prompts you for the device number (from the divvy 
table displayed above), then for anew name. This is the same pro- 
cedure for a character division. 


Option ‘o’ selects a file system, or division, for overwriting when 
you exit from divvy. Notice that if you select an existing file system 
with: the ‘o’ option, you see a ‘yes’ in the overwrite column. If you 
select option ‘p,’ the ‘yes’ changes to a ‘no.’ 

With the ‘s’ or ‘start? command, you can start a division or file sys— 
tem on a new block number. You can start the division on any legal 
block, which includes: 

— A block number less that the highest block on your disk. 

- A block not already used by another division in this table. 


- A block that is continuous with the rest of the division (does 
not span another block). 


The same rules for ‘s’ apply for the ‘e’ or ‘end’ command. 

You can use these two commands to change the size of a partition. 
For example, if your disk is similar to the one in the example divvy 
table above, and you want to make the root file system smaller and 
the swap area larger, do this: 


Make the root division smaller with the ‘s’ command. 


Increase the size of the swap area, using blocks freed from 
the root file system. 
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The ‘t’ or ‘trade’ option switches the block size of two divisions. 
For example, you could trade root for swap in our example above. 
root would then be as large as swap and vice-versa. 


The ‘r’ or ‘restore’ command restores a default root partition table. 
This is useful if you make a serious mistake and want to return 
from where you started. 


When you exit from divvy, you are prompted whether you want to 
Save any changes you made, or exit without saving the changes. At 
this time, you can also go back to the divyy menu, and you may 
have the option to reinstall the original, default partition table. 


See Also 
badtrk(M), fdisk(C), hd(M), mkdev(C), mkfs(C), mknod(C) 


Notes 


divvy requires kernel level support from the device driver. If divvy 
displays the messages: 


cannot read division table 
or 
cannot get drive parameters 


or lists the size of a disk as “0” blocks, the device may not support 
dividing. These errors may also occur if the prerequisite programs 
fdisk and badtrk are not completed correctly. 


If you change the size of filesystems (such as root or u) after you 
have installed XENIX, you will have to reinstall the files that reside 
in that partition. This is because the inode table for that filesystem 
has changed. Be sure to backup (using backup(C), tar(C), or 
cpio(C)) the files in any filesystem you intend to change before 
using divvy . 
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Name 


dmesg - Displays the system messages on the console. 


Syntax 


dmesg [ - | 


Description 

The dmesg command displays all the system messages that have 
been generated since the last time the system was booted. If the - 
option is specified, it displays only those messages that have been 
generated since the last time the dmesg command was performed. 
Dmesg is periodically invoked by the system according to the 
instructions in the file /usr/lib/crontab. It is also automatically 
invoked by the /etc/rc file whenever the system is booted. 

A history of all system messages ever generated is recorded in 


/usr/adm/messages. This file will continue to grow unless the user 
occasionally erases its contents. 


Files 
/etc/dmesg /etc/rc /usr/adm/messages /usr/adm/msgbuf 


/usr/lib/crontab 


See Also 
cron(C) 
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Name 


DOS (C) 


dos — Accesses DOS files. 


Syntax 


doscat [ —r | 


file ... 


doscp [ -r | file1 file2 


doscp [ -r | file .... directory 


dosdir directory ... 


dosls directory ... 


dosmkdir directory ... 


dosrm file ... 


dosrmdir directory ... 


Description 


The dos commands provide access to the files and directories on 
MS-DOS disks and on a DOS partition of the hard disk. The com- 
mands perform the following actions: 


doscat 


doscp 


dosdir 


dosls 


dosrm 


dosmkdir 
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Copies one or more DOS files to the standard output. 
If —r is given, the files are copied without newline 
conversions (see “Conversions” below). 


Copies files between an DOS disk and a XENIX file 
system. If filel and file2 are given, filel is copied to 
file2. If a directory is given, one or more files are 
copied to that directory. If the —r is given, the files 
are copied without newline conversions (see “Conver- 
sions” below). 


Lists DOS files in the standard DOS style directory for- 
mat. 


Lists DOS directories and files in a XENIX style (see 
ls(C)). 


Removes files from an DOS disk. 


Creates a directory on an DOS disk. 
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dosrmdir Deletes directories from an DOS disk. 


The file and directory arguments for DOS files and directories have 
the form: 


device:name 


where device is a XENIX pathname for the special device file con- 
taining the DOS disk, and name is a pathname to a file or directory 
on the DOS disk. The two components are separated by a colon (:). 
For example, the argument: 


/dev/fd0:/src/file.asm 


specifies the DOS file, file.asm, in the directory, /sre, on the disk 
in the device file /dev/fd0. Note that slashes (and not backslashes) 
are used as filename separators for DOS pathnames. Arguments 
without a device: are assumed to be XENIX files. 


For convenience, the default file, /etc/default/msdos, can define 
DOS drive names to be used in place of the special device file path- 
names. For example, if the file contains the following line: 


A=/dev/fd0 


then drive letter ““A”’ may be used in place of special device file 
pathname /dev/fd0 when referencing DOS files (see “Examples” 
below). 


The commands operate on the following kinds of disks: 


DOS partitions on a hard disk 
5 1/4 inch DOS 

8 or 9 sectors per track 

40 tracks per side 

1 or 2 sides 

DOS version 1.0 or 2.0 


Converisons 


All DOS text files use a carriage-return/linefeed combination, CR- 
LF , to indicate a newline. XENIX uses a single newline LF charac- 
ter. When the doscat and doscp commands transfer DOS text files 
to XENIX , they automatically strip the CR. When text files are 
transferred to DOS , the commands insert the CR before each LF 
character. The —r option can be used to override the automatic 
conversion and force the command to perform a true byte copy 
regardless of file type. 
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Examples 


doscat /dev/fd0:/docs/memo.txt 
doscat /tmp/f1 /tmp/f2 /dev/fd0:/src/file.asm 


dosdir /dev/fd0:/src 
dosdir A:/src A:/dev 


doscp /tmp/myfile.txt /dev/fd0:/docs/memo.txt 
doscp /tmp/f1 /tmp/f2 /dev/fd0:/mydir 


dosls /dev/fd0:/src 
dosls B: 


dosmkdir /dev/fd0:/usr/docs 


dosrm /dev/fd0:/docs/memo.txt 
dosrm A:/docs/memol1.txt 


dosrmdir /dev/fd0:/usr/docs 


Files 
/etc/default/msdos Default information 
/dev/fd* Floppy disk devices 
/dev/hd* Hard disk devices 


See Also 


assign(C), dtype(C) 


Notes 


It is not possible to refer to DOS directories with wild card 
specifications. The programs mentioned above cooperate among 
themselves so no two programs will access the same DOS disk. 
Only one process will access a given DOS disk at any time, while 
other processes wait. If a process has to wait too long, it displays 
the error message, “‘can’t seize a device,” and exits with an exit 
code of 1. 
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Name 


dtype — Determines disk type. 


Syntax 


dtype [—s] device ... 


Description 


Dtype determines type of disk, prints pertinent information on the 
standard output unless the silent (—s) option is selected, and exits 
with a corresponding code (see below). When more than one argu- 
ment is given, the exit code corresponds to the last argument. 
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DOS 2.x, 8 sec/track dual sided 
DOS 2.x, 9 sec/track, single sided 
DOS 2.x, 9 sec/track, dual sided 


Notes 


word-swapped refers to byte ordering of long words in relation to 
the host system. 


XENIX file systems and dump and cpio binary formats may not be 
recognized if created on a foreign system. This is due to such sys- 
tem differences as byte and word swapping and structure alignment. 


This utility only works reliably for floppy diskettes. 
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Name 


du — Summarizes disk usage. 


Syntax 


du [ —afrsu | [ names | 


Description 


Du gives the number of blocks contained in all files and (recur- 
sively) directories within each directory and file specified by the 
names argument. The block count includes the indirect blocks of 
the file. If names is missing, the current directory is used. 


The optional argument —s causes only the grand total (for each of 
the specified names) to be given. The optional argument —a causes 
an entry to be generated for each file. Absence of either causes an 
entry to be generated for each directory only. 


The —f option causes du to display the usage of files in the current 
file system only. Directories containing mounted file systems will 
be ignored. The —u option causes du to ignore files that have 
more than one link. 


Du is normally silent about directories that cannot be read, files 
that cannot be opened, etc. The —r option will cause du to gen- 
erate messages in such instances. 


A file with two or more links is only counted once. 


Notes 


If the —a option is not used, nondirectories given as arguments are 
not listed. 


If there are too many distinct linked files, du will count the excess 
files more than once. 


Files with holes in them will get an incorrect block count. 


This utility reports sizes in 512 byte blocks. On systems which use 
1024 byte blocks, this means a file of 500 bytes is reported to be Z 
blocks by du since the file uses one system block of 1024 bytes. 
Refer to the machine(M) manual page for the block size used by 

your system. 
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Name 


dump — Performs incremental file system backup. 


Syntax 


dump [ key [ arguments ] fiicsystem | 


Description 


Dump copies to the specified device all files changed after a certain 
date in the filesystem. The key specifies the date and other options 
about the backup, where a key consists of characters from the set 
0123456789kfusd. The meanings of these characters are described 
below: 


f 


Places the backup on the next argument file instead of the 
default device. 


If the backup completes successfully, writes the date of the 
beginning of the backup to the file /etc/ddate. ‘this file 
records a separate date for each file system and each backup 
level. 


This number is the ‘‘backup level”. Backs up all files 
modified since the last date stored in the file /etc/ddate for 
the same file system at lesser levels. If no date is determined 
by the level, the beginning of time is assumed; thus the option 
0 causes the entire file system to be backed up. 


For backups to magnetic tape, the size of the tape specified in 
feet. The number of feet is taken from the next argument. 
When the specified size is reached, dump will wait for reels to 
be changed. The default size is 2,300 feet. 


For backups to magnetic tape, the density of the tape, 
expressed in BPI, is taken from the next argument. This is 
used in calculating the amount of tape used per write. The 
default is 1600. 


This option is used when backing up to a block-structured 
device, such as a floppy disk. The size (in K-bytes) of the 
volume being written is taken from the next argument. If the k 
argument is specified, any s and d arguments are ignored. 
The default is to use s and d. 


If no arguments are given, the key is assumed to be 9u and a 
default file system is backed up to the default device. 
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The first backup should be a full level-O backup: 
dump Ou 


Next, periodic level 9 backups should be made on an exponential 
progression of tapes or floppies: 


dump 9u 
This progression is shown as follows: 


$21 S225 4.5 


where backup 1 is used every other time, backup 2 every fourth, 
backup 3 every eighth, etc.) When the level-9 incremental backup 
becomes unmanageable because a tape is full or too many floppies 
are required, a level-1 backup should be made: 


dump lu 


After this, the exponential series should progress as if uninter- 
rupted. These level-9 backups are based on the level-1 backup, 
which is based on the level-O full backup. This progression of lev- 
els of backups can be carried as far as desired. 


The default file system and the backup device depend on the set- 
tings of the variables DISK and TAPE, respectively, in the file 
/etc/default/dump. 


Files 
/etc/ddate Records backup dates of file system/level 
etc/default/dump Default dump information 

See Also 


XENIX Operations Guide 
cpio(C), default(M), dumpdir(C), restore(C), dump(F) 
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Diagnostics 


If the backup requires more than one volume (where a volume is 
likely to be a floppy disk or tape), you will be asked to change 
volumes. Press RETURN after changing volumes. 


Notes 
Sizes are based on 1600 BPI for blocked tape; the raw magnetic 
tape device has to be used to approach these densities. Write 
errors to the backup device are usually fatal. Read errors on the 
file system are ignored. 
It is not possible to successfully restore an entire active root file sys- 
tem. 

Warning 
When backing up to floppy disks, be sure to have enough formatted 
floppies ready before starting a backup. 
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Name 


dumpdir — Prints the names of files on a backup archive. 


Syntax 


dumpdir [ f filename ] 


Description 


Dumpdir is usea to list the names and inode numbers of all files 
and directories on an archive written with the backup command. 
This is most useful when attempting to determine the location of a 
particular file in a set of backup archives. 


The f option causes filename to be used as the name of the backup 
device instead of the default. The backup device depends on the 
setting of the variable TAPE in the file /etc/default/dumpdir. The 
device specified as TAPE can be any type of backup device sup- 
ported by the system (for example, a floppy drive or cartridge tape 
drive). 

Files 


rst* Temporary files 


See Also 


backup(C), restore(C), default(M) 


Diagnostics 
If the backup extends over more than one volume (where a volume 


is likely a floppy disk or tape), you will be asked to change 
volumes. Press RETURN after changing volumes. 
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Name 


echo — Echoes arguments. 


Syntax 


echo [ arg]... 


Description 


Echo writes its arguments separated by blanks and terminated by a 
newline on the standard output. Echo also understands C-like 
escape conventions. The following escape sequences need to be 
quoted so that the shell interprets them correctly: 


\b Backspace 

\c Prints line without newline; same as use of —n option 
\f Form feed 

\n Newline 

\r Carriage return 

\t Tab 

\v Vertical tab 

eo \\ Backslash 


\z The 8-bit character whose ASCII code is the 1, 2 or 3-digit octal 
number m1 must start with a zero 


Echo is useful for producing diagnostics in command files and for 
sending known data into a pipe. 


See Also 
sh(C) 
Notes 
The csh(C) has a built-in ecru utility which has a different syntax 


than this echo. Be aware that users running under csh will get the 
built-in echo unless they specify /bin/echo. 
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Name 


ed — Invokes the text editor. 


Syntax 


ed [ — ][ —p string | [ file | 


Description 


Ed is the standard text editor. If the file argument is given, ed 
simulates an e command (see below) on the named file; that is to 
say, the file is read into ed’s buffer so that it can be edited. Ed 
operates on a copy of the file it is editing; changes made to the 
copy have no effect on the file until a w (write) command is given. 
The copy of the text being edited resides in a temporary file called 
the buffer. There is only one buffer. 


The options are: 


— Suppresses the printing of character counts by the e, r, and w 
commands, of diagnostics from e and gq commands, and the! 
prompt after a !shell command. 


-—p Allows the user to specify a prompt string. 


Ed supports formatting capability. After including a format 
specification as the first line of file and invoking ed with your termi- 
nal in stty -tabs or stty tab3 mode (see stty(C), the specified tab 
stops will automatically be used when scanning file. For example, if 
the first line of a file contained: 


45.40.15 S7oo> 


tab stops would be set at columns 5, 10, and 15, and a maximum 
line length of 72 would be imposed. NOTE: While inputting text, 
tab characters are expanded to every eighth column as the default. 


Commands to ed have a simple and regular structure: zero, one, or 
two addresses followed by a single-character command, possibly 
followed by parameters to that command. These addresses specify 
one or more lines in the buffer. Every command that requires 
addresses has default addresses, so that the addresses can very 
often be omitted. 
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In general, only one command may appear on a line. Certain com- 
mands allow the input of text. This text is placed in the appropn- 
ate place in the buffer. While ed is accepting text, it is said to be in 
input mode. In this mode, no commands are recognized; all input 
is merely collected. Input mode is left by entering a period Lay 
alone at the beginning of a line. 


Ed supports a limited form of regular expression notation; regular 
expressions are used in addresses to specify lines and in some com- 
mands (e.g., s) to specify portions of a line that are to be substi- 
tuted. A regular expression specifies a set of character strings. A 
member of this set of strings is said to be matched by the regular 
expression. The regular expressions allowed by ed are constructed 
as follows: 


The following one-character regular expressions match a single 
character: 


1.1 An ordinary character (not one of those discussed in 1.2 
below) is a one-character regular expression that matches 
itself. 


1.2 A backslash (\) followed by any special character is a one- 
character regular expression that matches the special charac- 
ter itself. The special characters are: 


a. ., *, [, and \ (dot, star, left square bracket, and 
backslash, respectively), which are always special, except 
when they appear within square brackets ([]; see 1.4 
below). 


b. ~* (caret), which is special at the beginning of an entire 
regular expression (see 3.1 and 3.2 below), or when it 
immediately follows the left of a pair of square brackets 
(L]) (see 1.4 below). 


c. $ (dollar sign), which is special at the end of an entire 
regular expression (see 3.2 below). 


d. The character used to bound (i.e., delimit) an entire reg- 
ular expression, which is special for that regular expres- 
sion (for example, see how slash (/) is used in the g 
command below). 


1.3 A period (.) is a one-character regular expression that 
matches any character except newline. 


1.4 A nonempty string of characters enclosed in square brackets 
({]) is a one-character regular expression that matches any 
one character in that string. If, however, the first character 
of the string is a caret (~), the one-character regular expres- 
sion matches any character except newline and the remaining 
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characters in the string. The star (*) has this special meaning 
only if it occurs first in the string. The dash (—) may be used 
to indicate a\range of consecutive ASCII characters; for 
example, [0-9] is equivalent to [0123456789]. The dash (—) 
loses this special meaning if it occurs first (after an initial 
caret (*), if any) or last in the string. The mght square 
bracket (]) does not terminate such a string when it is the 
first character within it (after an initial caret (*), if any); e.g., 
[]a—f] matches either a right square bracket (]) or one of the 
letters ‘‘a” through “‘f” inclusive. Dot, star, left bracket, and 
the backslash lose their special meaning within such a string 
of characters. 


The following rules may be used to construct regular expressions 
from one-character regular expressions: 


poe | 


ae 


pe 


2.4 


ee 


2.6 


A one-character regular expression matches whatever the 
one-character regular expression matches. 


A one-character regular expression followed by a star (*) is a 
regular expression that matches zero or more occurrences of 
the one-character regular expression. If there is any choice, 
the longest leftmost string that permits a match is chosen. 


A one-character regular expression followed by \{m\f, 
\im,\}, or \{m,n\} is a regular expression that matches a 
range of occurrences of the one-character regular expression. 
The values of m and 1 must be nonnegative integers less than 
255; \{m\} matches exactly m occurrences; \{m, \} matches 
at least m occurrences; \{m,n\} matches any number of 
occurrences between m and n, inclusive. Whenever a choice 
exists, the regular expression matches as many occurrences as 
possible. 


The concatenation of regular expressions is a regular expres- 
sion that matches the concatenation of the strings matched by 
each component of the regular expression. 


A regular expression enclosed between the _ character 
sequences \( and \) is a regular expression that matches what- 
ever the unadorned regular expression matches. See 2.6 
below for a discussion of why this is useful. 


The expression \z matches the same string of characters as 
was matched by an expression enclosed between \( and 
earlier in the same regular expression. Here n is a digit; the 
subexpression specified is that beginning with the n-th 
occurrence of \( counting from the left. For example, the 
expression ~\(.*\)\1$ matches a line consisting of two 
repeated appearances of the same string. 
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Finally, an entire regular expression may be constrained to match 
only an initial segment or final segment of a line (or both): 


3.1 A caret (*) at the beginning of an entire regular expression 
constrains that regular expression to match an initial segment 
of a line. 


3.2 A dollar sign ($) at the end of an entire regular expression 
constrains that regular expression to match a final segment of 
a line. The construction “entire regular expression$ con- 
strains the entire regular expression to match the entire line. 


The null regular expression (e.g., //) is equivalent to the last regular 
expression encountered. 


To understand addressing in ed , it is necessary to know that there 
is a current line at all times. Generally speaking, the current line is 
the last line affected by a command; the exact effect on the current 
line is discussed under the description of each command. 
Addresses are constructed as follows: 


1. The character . addresses the current line. 

2. The character $ addresses the last line of the buffer. 

3. A decimal number 7 addresses the -th line of the buffer. 
4 


'y addresses the line marked with the mark name character x, 
which must be a lowercase letter. Lines are marked with the 
k command described below. 


5. A regular expression enclosed by slashes (/) addresses the 
first line found by searching forward from the line following 
the current line toward the end of the buffer and stopping at 
the first line containing a string matching the regular expres- 
sion. If necessary, the search wraps around to the beginning 
of the buffer and continues up to and including the current 
line, so that the entire buffer is searched. 


6. A regular expression enclosed in question marks (?) 
addresses the first line found by searching backward from the 
line preceding the current line toward the beginning of the 
buffer and stopping at the first line containing a string match- 
ing the regular expression. If necessary, the search wraps 
around to the end of the buffer and continues up to and 
including the current line. See also the last paragraph before 
Files below. 


7. An address followed by a plus sign (+) or a minus sign (—) 
followed by a decimal number specifies that address plus or 
minus the indicated number of lines. The plus sign may be 
omitted. 
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8. If an address begins with + or —, the addition or subtraction 
is taken with respect to the current line; e.g, —5 is under- 
stood to mean .=5. 


9. If an address ends with + or —, then 1 is added to or sub- 
tracted from the address, respectively. As a consequence of 
this rule and of rule 8 immediately above, the address — 
refers to the line preceding the current line. (To maintain 
compatibility with earlier versions of the editor, the character 
“ in addresses is entirely equivalent to —.) Moreover, trailing 
+ and — characters have a cumulative effect, so —— refers to 
the current line less 2. 


10. For convenience, a comma (,) stands for the address pair 
1,$, while a semicolon (;) stands for the pair .,$. 


Commands may require zero, one, or two addresses. Commands 
that require no addresses regard the presence of an address as an 
error. Commands that accept one or two addresses assume default 
addresses when an insufficient number of addresses is given; if 
more addresses are given than such a command requires, the last 
address(es) are used. 


Typically, addresses are separated from each other by a comma (,). 
They may also be separated by a semicolon (;). In the latter case, 
the current line (.) is set to the first address, and only then is the 
second address calculated. This feature can be used to determine 
the starting line for forward and backward searches (see rules 5 and 
6 above). The second address of any two-address sequence must 
correspond to a line that follows, in the buffer, the line correspond- 
ing to the first address. 


In the following list of ed commands, the default addresses are 
shown in parentheses. The parentheses are not part of the address; 
they show that the given addresses are the default. 


It is generally illegal for more than one command to appear on a 
line. However, any command (except e, f, r, or w) may be 
suffixed by p or by Il, in which case the current line is either printed 
or listed, respectively, as discussed below under the p and / com- 
mands. 


(.)a 
<text> 


The append command reads the given text and appends it after 
the addressed line; dot is left at the last inserted line, or, if 
there were no inserted lines, at the addressed line. Address 0 is 
legal for this command: it causes the “appended” text to be 
placed at the beginning of the buffer. 
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(.)e 


<text> 
The 


change command deletes the addressed lines, then accepts input 
text that replaces these lines; dot is left at the last line input, or, if 
there were none, at the first line that was not deleted. 


er 
The delete command deletes the addressed lines from the 
buffer. The line after the last line deleted becomes the current 
line; if the lines deleted were originally at the end of the buffer, 
the new last line becomes the current line. 


e file 

The edit command causes the entire contents of the buffer to be 
deleted, and then the named file to be read in; dot is set to the 
last line of the buffer. If no filename is given, the currently 
remembered filename, if any, is.used (see the f command). The 
number of characters read is typed; file is remembered for pos- 
sible use as a default filename in subsequent e, 7, and w com- 
mands. If file begins with an exclamation (!), the rest of the 
line is taken to be a shell command. The output of this com- 
mand is read for the e and r commands. For the w command, 
the file is used as the standard input for the specified command. 
Such a shell command is not remembered as the current 
filename. 


E file 
The Edit command is like e, except the editor does not check 
to see if any changes have been made to the buffer since the last 
w command. 


f file 
If file is given, the filename command changes the currently 
remembered filename to file; otherwise, it prints the currently 
remembered filename. 


(1, $)g/regular-expression/command list 

In the global command, the first step is to mark every line that 
matches the given regular expression. Then, for every such line, 
the given command list is executed with . initially set to that 
line. A single command or the first of a list of commands 
appears on the same line as the global command. All lines of a 
multiline list except the last line must be ended with a \; a, i, 
and c commands and associated input are permitted; the . ter- 
minating input mode may be omitted if it would be the last line 
of the command list. An empty command list is equivalent to 
the p command. The g, G, v, and V commands are not permit- 
ted in the command list. See also Notes and the last paragraph 
before Files below. 
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(1,$)G/regular-expression/ 

In the interactive Global command, the first step is to mark 
every line that matches the given regular expression. Then, for 
every such line, that line is printed, dot (.) is changed to that 
line, and any one command (other than one of the a, c, i, g, 
G, v, and V commands) may be input and is executed. After 
the execution of that command, the next marked line is printed, 
and so on; a newline acts as a null command; an ampersand (&) 
causes the re-execution of the most recent command executed 
within the current invocation of G. Note that the commands 
input as part of the execution of the G command may address 
and affect any lines in the buffer. The G command can be ter- 
minated by entering an INTERRUPT. 


The help command gives a short error message that explains the 
reason for the most recent ? diagnostic. 


The Help command causes ed to enter a mode in which error 
messages are printed for all subsequent ? diagnostics. It will 
also explain the previous diagnostic if there was one. The H 
command alternately turns this mode on and off; it is initially 
on. 


(.)i 
<text> 


The insert command inserts the given text before the addressed 
line; dot is left at the last inserted line, or if there were no 
inserted lines, at the addressed line. This command differs from 
the @ command only in the placement of the input text. 
Address 0 is not legal for this command. 


(.,.#1)j 
The join command joins contiguous lines by removing the 
appropriate newline characters. If only one address is given, 
this command does nothing. 


(.)kx 
The mark command marks the addressed line with name x, 
which must be a lowercase letter. The address x then addresses 
this line; dot is unchanged. 


bageas 
The list command prints the addressed lines in an unambiguous 
way: a few nonprinting characters (e.g., tab, backspace) are 
represented by mnemonic overstrikes, all other nonprinting 
characters are printed in octal, and long lines are folded. An/ 
command may be appended to any command other than e, f, r, 
Or Ww. 
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(.,-)ma 
The move command repositions the addressed line(s) after the 
line addressed by a. Address 0 is legal for a and causes the 
addressed line(s) to be moved to the beginning of the file; it is 
an error if address a falls within the range of moved lines; dot is 
left at the last line moved. 


Cy, a 
The mumber command prints the addressed lines, preceding 
each line by its line number and a tab character; dot is left at 
the last line printed. The m command may be appended to any 
command other than e, f, r, or w. 


(.,-)p 
The print command prints the addressed lines; dot is left at the 
last line printed. The p command may be appended to any 
command other than e, f, r, or w; for example, dp deletes the 
current line and prints the new current line. 


The editor will prompt with a * for all subsequent commands. 
The P command alternately turns this mode on and off; it is ini- 
tially on. 


The quit command causes ed to exit. No automatic write of a 
file is done. 


The editor exits without checking if changes have been made in 
the buffer since the last w command. 


($)r file 

The read command reads in the given file after the addressed 
line. If no filename is given, the currently remembered 
filename, if any, is used (see e and f commands). The currently 
remembered filename is not changed unless file is the very first 
filename mentioned since ed was invoked. Address 0 is legal 
for r and causes the file to be read at the beginning of the 
buffer. If the read is successful, the number of characters read 
is typed; dot is set to the last line read in. If file begins with !, 
the rest of the line is taken to be a shell (sh(C)) command 
whose output is to be read. Such a shell command is not 
remembered as the current filename. 


(.,.)s/regular-expression/replacement/ or 
(.,.)s/regular-expression/replacement/g or 


(.,.)s/regular-expression/replacement/n n=1-512 
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The substitute command searches each addressed line for an 
occurrence of the specified regular expression. In each line in 
which a match is found, all (nonoverlapped) matched strings are 
replaced by the replacement if the global replacement indicator g 
appears after the command. If the global indicator does not 
appear, only the first occurrence of the matched string is 
replaced. It is an error for the substitution to fail on all 
addressed lines. Any character other than space or newline may 
be used instead of / to delimit the regular expression and the 
replacement; dot is left at the last line on which a substitution 
occurred. 


An ampersand (&) appearing in the replacement is replaced by 
the string matching the regular expression on the current line. 
The special meaning of the ampersand in this context may be 
suppressed by preceding it with a backslash. The characters \, 

where 7 is a digit, are replaced by the text matched by the n-th 
regular subexpression of the specified regular expression 
enclosed between \( and \. When nested parenthesized subex- 
pressions are present, n is determined by counting occurrences 
of \( starting from the left. When the character % is the only 
character in the replacement, the replacement used in the most 
recent substitute command is used as the replacement in the 
current substitute command. The % loses its special meaning 
when it is in a replacement string of more than one character or 
is preceded by a \, 


oe A line may be split by substituting a newline character into it. 
The newline in the replacement must be escaped by preceding it 
with a \ Such a substitution cannot be done as part of a g or 
vy command list. 


(.,.)ta 
This command acts just like the m command, except that a 
copy of the addressed lines is placed after address a (which may 
be 0); dot is left at the last line of the copy. 


The undo command nullifies the effect of the most recent com- 
mand that modified anything in the buffer, namely the most 
recent a,c, d,g,i,j, m,r,5s,t,v, G, or V command. 


(1,$)v/regular-expression/command list 
This command is the same as the global command g except that 
the command list is executed with dot initially set to every line 
that does not match the regular expression. 


(1,$)V/regular-expression/ 
This command is the same as the interactive global command G 
except that the lines that are marked during the first step are 
those that do not match the regular expression. 
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(1,$)w file 
The write command writes the addressed lines into the named 
file. If the file does not exist, it is created with mode 666 (read- 
able and writeable by everyone), unless the umask setting (see 
sh(C)) dictates otherwise. The currently remembered filename 
is not changed unless file is the very first filename mentioned 
since ed was invoked. If no filename is given, the currently 
remembered filename, if any, is used (see e and f commands); 
dot is unchanged. If the command is successful, the number of 
characters written is displayed. If file begins with an exclama- 
tion (!), the rest of the line is taken to be a shell command to 
which the addressed lines are supplied as the standard input. 
Such a shell command is not remembered as the current 

filename. 


($)= 
The line number of the addressed line is typed; dot is 
unchanged by this command. 


'shell command 

The remainder of the line after the ! is sent to the XENIX shell 
(sh(C)) to be interpreted as acommand. Within the text of that 
command, the unescaped character % is replaced with the 
remembered filename; if a ! appears as the first character of the 
shell command, it is replaced with the text of the previous shell 
command. Thus, !! will repeat the last shell command. If any 
expansion is performed, the expanded line is echoed; dot is 
unchanged. . 


(.+1) 
An address alone on a line causes the addressed line to be 
printed. A RETURN alone on a line is equivalent to .+1p. This 
is useful for stepping forward through the editing buffer a line at 
a time. 


If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a 
question mark (?) and returns to its command level. 


Some size limitations: 512 characters per line, 256 characters per 
global command list, 64 characters per filename, and 128K charac- 
ters in the buffer. The limit on the number of lines depends on the 
amount of user memory. 


When reading a file, ed discards ASCII NUL characters and all 
characters after the last newline. Files (e.g., a.out) that contain 
characters not in the ASCII set (bit 8 on), cannot be edited by ed. 


If the closing delimiter of a regular expression or of a replacement 
string (e.g., /) would be the last character before a newline, that 
delimiter may be omitted, in which case the addressed line iS 
printed. Thus, the following pairs of commands are equivalent: 
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s/s1/s2s/s1/s2/p 
g/sig/s1/p 


2s1?s1? 
Files 
/tmp/e# Temporary; # is the process number 


ed.hup Work is saved here if the terminal is hung up 


See Also 


grep(C), sed(C), sh(C), stty(C), regexp(S) 


Diagnostics 


é 4 Command errors 
? file An inaccessible file 


Use the help and Help commands for detailed explanations. 


If iuasee have been made in the buffer since the last w command 
that wrote the entire buffer, ed warns the user if an attempt is made 
to destroy ed’s buffer via the e or q commands: it prints ? and 
allows you to continue editing. A second e or g command at this 
point will take effect. The dash (—) command-line option inhibits 
this feature. 


Notes 


An exclamation (!) command cannot be subject to a g or a v com- 
mand. | 


The ! command and the ! escape from the e, r, and w commands 
cannot be used if the the editor is invoked eau a restricted shell 


(see sh(C)). 


The sequence \n in a regular expression does not match any char- 
acter. 


The J] command mishandles DEL. 


Because 0 is an illegal address for the w command, it is not possi- 
ble to create an empty file with ed. 


Characters are mashed to 7 bits on input. 
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If the editor input is coming from a command file tic:, éd fae = 
ed-cmd-file), the editor will exit at the first failure of a command in 


the command file. 
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Name 


enable — Turns on terminals and line printers. 


Syntax 
enable tty ... 
enable printers 
Description 


For terminals this program manipulates the /etc/ttys file and signals 
init to allow logins on a particular terminal. 


For line printers, enable activates the named printers and enables 
them to print requests taken by /p(C). Use lIpstat(C) to find the 
status of the printers. 
Examples 
A simple command to enable tty01 follows: 
enable tty01 
Files 
/dev/tty* 
/etc/ttys 


/usr/spool/|p/* 


See Also 
disable(C), getty(M), init(M), login(M), Ip(C), Ipstat(C), ttys(M) 


Warning 
Be absolutely certain to pause at least one minute before reusing 


this command or before using the disable command. Failure to do 
sO may cause the system to crash. 
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Name 


env — Sets environment for command execution. 


| Syntax 
be 
env [—] [ name=value |... [ command args ] 
Description 
Env obtains the current environment, modifies it according to its 
arguments, then executes the command with the modified environ- 
ment. Arguments of the form name=value are merged into the 
inherited environment before the command is executed. The — 
flag causes the inherited environment to be ignored completely, so 
that the command is executed with exactly the environment speci- 
fied by the arguments. 
If no command is specified, the resulting environment is printed, 
one name-value pair per line. 
See Also 
a sh(C), exec(S), profile(F), environ(M) 
Notes 
The 2.3 printenv command has been replaced in XENIX 3.0 and 
System V by the env command. The printenv shipped is a link to 
the command env. 
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Name 


ex — Invokes a text editor. 


Syntax 


ex[— ][-—v][—t tag ][—r][ +lineno | name ... 


Description 


Ex is the root of the editors ex and vi. Ex is a superset of ed, whose 
most notable extension is a display editing facility. Display based 
editing is the focus of wi. 


If you have not used ed, or if you are a casual user, you will find 
that edit is most convenient for you. It avoids some of the com- 
plexities of ex which is used mostly by systems programmers and 
persons very familiar with ed. 


If you have a CRT terminal, you may wish to use a display based 
editor; in this case see vi(C), a command which focuses on the 
display editing portion of ex. 


For ed Users 


If you have used ed you will find that ex has a number of new 
features. Intelligent terminals and high-speed terminals are very 
pleasant to use with vi. Generally, the ex editor uses far more of 
the capabilities of terminals than ed does. It uses the terminal capa- 
bility database termcap (M) and the type of the terminal you are 
using from the variable TERM in the environment to determine how 
to drive your terminal efficiently. The ex editor makes use of 
features such as insert and delete character and line in its visual 
command mode, which can be abbreviated vi , which is the central 
mode of editing when using vi(C). There is also an interline editing 
open command, (0) that works on all terminals. 


Ex contains a number of features for easily viewing the text of a 
file. The z command gives easy access to windows of text. Hitting 
Ctrl-D causes the editor to scroll a half-window of text and is more 
useful for quickly stepping through a file than just hitting the 
RETURN key. Of course, the screen-oriented visual mode gives 
constant access to editing context. 
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Ex gives you more help when you make mistakes. The undo (u) 
command allows you to reverse any single change. Ex gives you a 
lot of feedback, normally printing changed lines, and indicates 
when more than a few lines are affected by a command so it 1s easy 
to detect when a command has affected more lines than it should 
have. 


The editor also normally prevents the overwriting of existing files 
unless you have edited them, so that you do not accidentally 
clobber with a write a file other than the one you are editing. If the 
system (or editor) crashes, or you accidentally hang up the phone, 
you can use the recover command to retrieve your work. This will 
get you back to within a few lines of where you left off. 


Ex has several features for editing more than one file at a time. 
You can give it a list of files on the command line and use the next 
(n) command to edit each in turn. You can also give the next com- 
mand a list of filenames, or a pattern used by the shell to specify a 
new set of files to be edited. In general, filenames in the editor 
may be formed with full shell metasyntax. The metacharacter ae ad 
is also available in forming filenames and is replaced by the name 
of the current file. For editing large groups of related files, you can 
use ex’s tag command to quickly locate functions and other impor- 
tant points in any of the files. This is useful when you want to find 
the definition of a particular function in a large program. The com- 
mand ctags(CP) builds a tags file or a group of C programs. 


For moving text between files and within a file, the editor has a 
group of buffers named a through z. You can place text in these 
named buffers and carry it over when you edit another file. 


The command & repeats the last substitute command. There is 
also a confirmed substitute command. You give a range of substitu- 
tions to be done and the editor interactively prompts you whether 
each substitution is desired. 


You can use the substitute command in ex to systematically convert 
the case of letters between uppercase and lowercase. It is possible 
to ignore case in searches and substitutions. Ex also allows regular 
expressions that match words to be constructed. This is con- 
venient, for example, when searching for the word “edit” if your 
document also contains the word “editor.” 


Ex has a set of options that you can set. One option which is very 
useful is the autoindent option that allows the editor to automati- 
cally supply leading white space to align text. You can then press 
Ctrl-D to backtab, space and tab forward to align new code easily. 


Miscellaneous new useful features include an intelligent join (j) 


command which supplies whitespace between joined lines automati- 
cally, the commands < and > which shift groups of lines, and the 
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ability to filter portions of the buffer through commands such as 


sort. 

Files 

ee /usr/lib/ex3.7strings Error messages 

/usr/lib/ex3.7recover Recover command 
/usr/lib/ex3.7preserve Preserve command 
/etc/termcap Describes capabilities of terminals 
$HOME/.exrc Editor startup file 
/tmp/Exnnnnan Editor temporary 
/tmp/Rxnannn Named buffer temporary 
/usr/preserve Preservation directory 

See Also 


awk(C), ctags(CP), ed(C), grep(C), sed(C), termcap(M), vi(C) 


Ses Credit 
This utility was developed at the University of California at Berke- 
ley and is used with permission. 
Notes 


The undo command causes all marks to be lost on lines changed 
and then restored if the marked lines were changed. 


Undo never clears the buffer modified condition. 
The z command prints a number of logical rather than physical 
lines. More than a screen full of output may result if long lines are © 


present. 


File input/output errors don’t print a name if the command line 
‘S=?? Option is used. 


There is no easy way to do a single scan ignoring case. 


Because of the implementation of the arguments to next, only 512 
bytes of argument list are allowed there. 
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The format of /etc/termcap and the large number of capabilities of 
terminals used by the editor cause terminal type setup to be rather 
slow. 


The editor does not warn if text is placed in named buffers and not 
used before exiting the editor. 


Null characters are discarded in input files and cannot appear in 
resultant files. 
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Name 


expr — Evaluates arguments as an expression. 


Syntax 


expr arguments 


Description 


The arguments are taken as an expression. After evaluation, the 
result is written on the standard output. Terms of the expression 
must be separated by blanks. Characters special to the shell must 
be escaped. Note that zero is returned to indicate a zero value, 
rather than the null string. Strings containing blanks or other spe- 
cial characters should be quoted. Integer-valued arguments may be 
preceded by a unary minus sign. Internally, integers are treated as 
32-bit, 2’s complement numbers. 


The operators and keywords are listed below. Expressions should 
be quoted by the shell, since many of the characters that have spe- 
cial meaning in the shell also have special meaning in expr. The list 
is in order of increasing precedence, with equal precedence opera- 
tors grouped within braces ({ and }). 


expr | expr 
Returns the first expr if it is neither null nor 0, otherwise 
returns the second expr. 


expr & expr : 
Returns the first expr if neither expr is null nor 0, otherwise 
returns 0. 


expr { =, >, >=, <, <=, != } expr 
Returns the result of an integer comparison if both argu- 
ments are integers, otherwise returns the result of a lexical 
comparison. 


expr { +, — } expr 
Addition or subtraction of integer-valued arguments. 


expr { *, /, % } expr 
Multiplication, division, or remainder of the integer-valued 
arguments. 


expr : expr 
The matching operator : compares the first argument with 
the second argument which must be a regular expression; 
regular expression syntax is the same as that of ed(C), except 
that all patterns are “anchored” (i.e., begin with a caret (>) 
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and therefore the caret is not a special character in that con- 
text. (Note that in the shell, the caret has the same meaning 
as the pipe symbol (|).) Normally the matching operator 
returns the number of characters matched (zero on failure). 
Alternatively, the \(...\) pattern symbols can be used to 
return a portion of the first argument. 
Examples 
1. a=‘expr $a + 1s 
Adds 1 to the shell variable a. 


2. # For $a equal to either "/usr/abc/file" or just "/file” 
‘expr $a: .*/\(.*\) | $a’ 


Returns the last segment of a pathname (i.e., file). Watch 
out for the slash alone as an argument: expr will take it as 
the division operator (see Notes below). 


3. ‘expr -SVAR : *.* 


Returns the number of characters in $VAR. 


See Also 
ed(C), sh(C) 


Diagnostics 


As a side effect of expression evaluation, expr returns the following 
exit values: 


0 If the expression is neither null nor zero 
1 If the expression is null or zero 
2 For invalid expressions 


Other diagnostics include: 
syntax error For operator/operand errors 


nonnumeric argument 
If arithmetic is attempted on such a string 
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Notes 
om, After argument processing by the shell, expr cannot tell the 


difference between an operator and an operand except by the value. 
If $a is an equals sign (=), the command: 


aoe expr $a = = 
looks like: 
expr = = = 


Thus the arguments are passed to expr (and will all be taken as the 
= operator). The following permits comparing equals signs: 


expr X$a = X= 
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Name 


factor — Factor a number. 


Syntax 


factor [ number | 


Description 


When factor is invoked without an argument, it waits for a number 
to be typed in. If you type in a positive number less than 2” (about 
7.210") it will factor the number and print its prime factors; each 
one is printed the proper number of times. Then it waits for 
another number. It exits if it encounters a zero or any non-numeric 
character. 


If factor is invoked with an argument, it factors the number as 
above and then exits. 


The time it takes to factor a number, n, is proportional to Jn. It 
usually takes longer to factor a prime or the square of a prime, than 
to factor other numbers. 


Diagnostics 


factor returns an error message if the supplied input value is greater 
than 2” or is not an integer number. 
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Name 


false — Returns with a nonzero exit value. 


Syntax 


false 


Description 

False does nothing except return with a nonzero exit value. 
True(C), false’s counterpart, does nothing except return with a zero 
exit value. False is typically used in shell procedures such as: 

until false 

do 

command 
done 


See Also 
sh(C), true(C) 


Diagnostics 


False is any non-zero value. 
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Name 


fdisk — Maintain disk partitions. 


Syntax 
fdisk [-f device] 


Description 


fdisk displays information about disk partitions. fdisk also creates 
and deletes disk partitions and changes the active partition. fdisk 
functionality is a superset of the MS-DOS command of the same 
name. fdisk is used interactively from a menu. 


The hard disk has four partitions. Only one partition is active at 
any given time. It is possible to assign a different operating system 
to each partition and it must be active. Once a partition is made 
active, the operating system resident in that partition boots 
automatically once the current operating system is halted. 


To use XENIX, at least one partition must be assigned to XENIX. 


Partitions are defined by a “partition table” at the end of the mas-— 
ter boot block. The partition table provides the location and size 
of the partitions on the disk. The partition table also defines the 
active partition. Each partition can be assigned to XENIX, DOS, 
or some other operating system. Once a DOS partition is set up, 
DOS files and directories resident in the DOS partition may be 
accessed while running XENIX by means of the dos(C) commands. 


Arguments 


-f name 
Open device name and read the partition table associated with 
that devices’ partition. The default is /dev/hd00. 


Options 


The fdisk command displays a prompt and a menu of five options. 
Updates to the disk are not made until you confirm at exit. 


1. Display Partition Table. 
This option displays a table of information about each partition 
on the hard disk. The PARTITION column gives the partition 
number. The STATUS column tells whether the partition is 
active (A) or inactive (I). TYPE tells whether the partition is 
XENIX, DOS, or “other”. The option also displays the starting 
track, ending track and total number of tracks in each partition. 
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2. Use Entire Disk for XENIX. 
fdisk creates one partition that includes all the tracks on the 
disk. This partition is assigned to XENIX and is designated the 
active partition. 


3. Create XENIX Partition 
This option allows the creation of a partition by altering the par- 
tition table. fdisk reports the number of tracks available for 
each partition and the number of tracks in use. fdisk prompts 
for the partition to create, the starting track and size in tracks. 
The change is not made until confirmation upon exit. 


4. Activate XENIX Partition 
This option changes the active partition. Only one partition 
may be active at a time. The change is not effective until 
confirmation upon exit. The operating system residing in the 
newly activated partition boots once the current operating sys-— 
tem is halted. 


5. Delete XENIX Partition 
This option requests which partition you wish to delete. fdisk 
reports the new available amount of disk space in tracks. The 
change is not effective until confirmation upon exit. 


Exit the fdisk program by typing a ‘q’ at the main fdisk menu. fdisk 

asks for confirmation before it updates the changes to the hard disk 

partition table. If you answer ‘y’ for yes, the changes are made. If 

you answer ‘n’ for no, the changes are not made and fdisk exits. 
Notes 


The minimum recommended size for a XENIX partition is 6 mega— 
bytes. 


Since fdisk is intended for use with DOS, it may not work with all 
operating system combinations. 


See also 


dos(C), hd(M). 
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Name 


file - Determines file type. 


Syntax 
file [ —m ] file ... 


file [ —m | —f namesfile 


Description 


File performs a series of tests on each argument in an attempt to 
classify it. If an argument appears to be ASCII, file examines the 
first 512 bytes and tries to guess its language. 


If the —f option is given, file takes the list of filenames from names- 

file. If the —m option is given, file sets the access time for the 

examined file to the current time. Otherwise, the access time 

remains unchanged. 

Several object file formats are recognized. For a.out and x.out for- 

mat object files, the relationship of cc flags to file classification is 

—i for “separate”, —n for “pure”, and —s for not “not stripped.” 
Credit 

This utility was developed at the University of California at Berke- 

ley and is used with permission. 


Notes 


It can make mistakes: in particular it often mistakes command files 
for C programs. 
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Name 


FIND (C) 


find — Finds files. 


Syntax 


find pathname-list expression 


Description 


Find recursively descends the directory hierarchy for each path- 
name in the pathname-list (i.e., one or more pathnames) seeking 
files that match a Boolean expression written in the primaries given 
below. In the descriptions, the argument n is used as a decimal 
integer where +” means more than 1, —m means less than m and n 


means exactly n. 


—name file 


—perm onum 


—type x 


—links 1 


“user uname 


—group gname 


—size n 


—atime 7 
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True if file matches the current file name. Nor- 
mal shell argument syntax may be used if escaped 
(watch out for the left bracket ([), the question 
mark (?) and the star (*). 


True if the file permission flags exactly match the 
octal number onum (see chmod(C)). If onum is 
prefixed by a minus sign, more flag bits (017777, 
see stat(S)) become significant and the flags are 
compared. 


True if the type of the file is x, where c is b, ¢c, d, 
p, or f for block special file, character special file, 
directory, first-in-first-out, or plain file respec- 
tively. 


True if the file has 7 links. 


True if the file belongs to the user uname. If 
uname is numeric and does not appear as a login 
name in the /etc/passwd file, it is taken as a user 
ID. 


True if the file belongs to the group gname. If 
gname is numeric and does not appear in the 
/etc/group file, it is taken as a group ID. 


True if the file is m blocks long (512 bytes per 
block). 


True if the file has been accessed in n days. 
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—mtime 7 True if the file has been modified in n days. 
—ctime n True if the file has been changed in n days. 
—exec cmd True if the executed cmd returns a zero value as 
exit status. The end of cmd must be punctuated 
oe. by an escaped semicolon. A command argument 


{ } is replaced by the current path name. 


—ok cmd Like —exec except that the generated command 
line is printed with a question mark first, and is 
executed only if the user responds by typing y. 


—cpiodevice Always true; write the current file on device in 
cpio(F) format (5120-byte records). 


— print Always true; causes the current path name to be 
printed. 
—newer file True if the current file has been modified more 


recently than the argument file. 


( expression ) True if the parenthesized expression is_ true 
(parentheses are special to the shell and must be 
escaped). 


The primaries may be combined using the following operators (in 


— order of decreasing precedence): 
negation . The negation of a primary is specified with the 
~ exclamation (!) unary not operator. 

AND The AND operation is implied by the juxtaposi- 
tion of two primaries. 

OR 
The OR operation is specified with the —o opera- 
tor given between two primaries. 

Example 

The following removes all files named a.out or *.out that have not 

been accessed for a week: 

find / \( -name a.out —o —name ’*.o’ \) —atime +7 —exec rm {}\ 
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Files 


/etc/passwd 
/etc/group 


See Also 


cpio(C)(F), sh(C), stat(S), test(C) 
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Name 


FIXHDR (C) 


fixhdr — Changes executable binary file headers. 


Syntax 


fixhdr option files 


Description 


fixhdr changes the header of output files created by link editors or 
assemblers. The kinds of modifications include changing the format 
of the header, the fixed stack size, the standalone load address, 
and symbol names. 


Using fixhdr allows the use of binary executable files, created under 
other versions or machines, by simply changing the header informa-— 
tion so that it is usable by the target cpu. 


These are the options to fixhdr : 


—Xa 


—xb 


—x4 


—-x5 [—n] 


~ax —c [11, 


—5x [-n] 


Change the x.out format of the header to the a.out for- 
mat. 


Change the x.out format of the header to the b.out for- 
mat. 


. Change the x.out format of the header to the 4.2BSD 


a.out format. 


Change the x.out format of the header to 5.2 (UNIX™ 
System V release 2) a.out format. The —n flag causes 
leading underscores on symbol names to be passed with 
no modifications. 


86] 

Change the a.out format of the header to the x.out for- 
mat. The —c flag specifies the target cpu. 11 specifies a 
PDP-11 cpu. 86 specifies one of the 8086 family of cpus 
(8086, 8088, 80186, or 80286). 


Change the b.out format of the header to the x.out for— 
mat. 


Change the 5.2 (UNIX System V release 2) a.out format 
of the header to the x.out format. The —n flag causes 
leading underscores on symbol names to be passed with 
no modifications. 
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—86x Add the x.out header format to the 86rel object module 
format. See 86rel(F). 


-—Fnum Add (or change) the fixed stack size specified in the 
x.out format of the header. num must be a hexadecimal 
number. 


-A num Add (or change) the standalone load address specified 
in the x.out format of the header. num must be a hexa- 
decimal number. 


-M[smlh] Change the model of the x.out or 86rel format. Model 
refers to the compiler model specified when creating the 
binary. s refers to small model, m refers to medium 
model, 1 refers to large model, and h refers to huge 
model. 


—v [2,3] Change the version of the x.out format of the header. 2 
changes the version to XENIX 2.0. 3 changes the version 
to XENIX 3.0. 
—s sl=s2 [-s s3=s4] 
Change symbol names, where symbol name s/J is 
changed to s2. 
Files 


/usr/bin/fixhdr 


See Also 
a.out(F), 86rel(F) 


Notes 


Give fixhdr one option at a time. If you need to make more than 
one kind of modification to a file, use fixhdr on the original file. 
Then use it again on the fixhdr output, specifying the next option. 
Copy the original file if you need an unmodified version as fixhdr 
makes the modifications directly to the file. 
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Name 


finger — Finds information about users. 


Syntax 


finger [ -bfilpqsw ] [login1 [login2 ...] ] 


Description 


By default finger lists the login name, full name, terminal name and 
write status (as a “‘*” before the terminal name if write permission 
is denied), idle time, login time, office location, and phone number 
(if they are known) for each current XENIX user. (Idle time is 
minutes if it is a single integer, hours and minutes if a colon (:) is 
present, or days and hours if a “d” is present.) 


A longer format also exists and is used by finger whenever a list of 
names is given. (Account names as well as first and last names of 
users are accepted.) This is a multiline format; it includes all the 
information described above as well as the user’s home directory 
and login shell, any plan which the person has placed in the file 
.plan in their home directory, and the project on which they are 
working from the file .project which is also in the home directory. 


Finger options are: 


—b 
Briefer long output format of users. 


—f Suppresses the printing of the header line (short format) 
—i Quick list of users with idle times. 


—1 Forces long output format. 


—p 
Suppresses printing of the .plan files. 


Quick list of users. 


“Ss 
Forces short output format. 


—Ww 
Forces narrow format list of specified users. 
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Files 
/etc/utmp 
/etc/passwd 


/usr/adm/lastlog 
$HOME/.plan 
$HOME/. project 


See Also 
who(C) 


Credit 


FINGER (C) 


Who file 


User names, offices, phones, 
login directories, and shells 


Last login times 
Plans 


Projects 


This utility was developed at the University of California at Berke- 
ley and is used with permission. 


Notes 


Only the first line of the .project file is printed. 


The “office” column of the output contains any text in the com- 
ment field of the user’s /etc/passwd file entry that immediately fol- 
lows a comma (,). For example, if the entry is 


johnd:eX8HinAk:201:50:John Doe, 321:/usr/johnd:/bin/sh 


the number 321 appears in the office column. 


Idle time is computed as the elapsed time since any activity on the 
given terminal. This includes previous invocations of finger which 
may have modified the terminal’s corresponding device file 


/dev/tty??. 
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Name 


format - format floppy disks 


Syntax 


eae format [-f] [-q] [device] [-i interleave] 
Description 

format formats diskettes for use with KENIX. It may be used either 

interactively or from the command line. The default drive is 

/dev/rfd0. 

Options 

The following command line options are available: 

-— Suppresses the interactive feature. The format program does 
not wait for user-confirmation before starting to format the 
diskette. Regardless of whether or not you run format interac- 
tively, track and head information is displayed. 

device 

emcee This specifies the device to be formatted. The default device is 
/dev/rfd0 . 


-i interleave 
Specifies the interleave factor. 


-q Quiet option. Suppresses the track and head output informa- 
tion normally displayed. Although this option does not 
suppress the interactive prompt, it would typically be used with 
-f to produce no output at all. 

Usage 
To run format interactively, enter: 


format 


followed by any of the legal options except -f, and press RETURN. 
When you run format interactively, you see the prompt: 


insert diskette in drive and press return when ready 


When you press RETURN at this prompt, format begins to format 
the diskette. 
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If you specify the -f option, you do not see this prompt. Instead, 
the program begins formatting immediately upon invocation. 


Unless you specify the -q option, format displays which track and 
head it is currently on: 


track # head # 


The number signs above are replaced by the actual track and head 
information. 


Files 


/dev/rfd[0- n] 


See Also 
fd(M) 


Notes 


It is not advisable to format a low density (48tpi) diskette on a high 
density (96tpi) floppy drive. Diskettes written on a high density 
drive should be read on high density drives. A low density diskette 
written on a high density drive may not be unreadable on a low | 
density drive. ee 
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Name 


fsck — Checks and repairs file systems. 


Syntax 


/bin/fsck [ options | [ file-system | ... 


Description 


Fsck audits and interactively repairs inconsistent conditions for 
XENIX System V file systems. If the file system is consistent, the 
the number of files, number of blocks used, and number of blocks 
free are reported. If the file system is inconsistent, the operator iS 
prompted for concurrence before each correction is attempted. It 
should be noted that most corrective actions result in some loss of 
data. The amount and severity of the loss may be determined from 
the diagnostic output. The default action for each consistency 
correction is to wait for the operator to respond “‘yes” or “no”. If 
the operator does not have write permission fsck defaults to the 
action of the -n option. 


The following flags are interpreted by fsck: 
-y Assumes a yes response to all questions asked by fsck. 


-n Assumes a no response to all questions asked by fsck; do 
not open the file system for writing. 


-sb:c Ignores the actual free list and (unconditionally) reconstructs 
a new one by rewriting the super-block of the file system. 
The file system must be unmounted while this is done. 


The -sb:c option allows for creating an optimal free-list 
organization. The following forms are supported: 


-S 
-sBlocks-per-cylinder: Blocks-to-skip (file system interleave) 
(for anything else) 


If b:c is not given, then the values used when the file system 
was created are used. If these values were not specified, 
then a reasonable default value is used. 


-S Conditionally reconstructs the free list. This option is like - 
sb:c above except that the free list is rebuilt only if there are 
no discrepancies discovered in the file system. Using - 
forces a “no” response to all questions asked by fsck. ‘This 
option is useful for forcing free list reorganization on uncon- 
taminated file systems. 


August 26, 1985 Page 1 


FSCK (C) FSCK (C) 


-t 


-D 


-f 


-IT 


-C 


If fsck cannot obtain enough memory to keep its tables, it 
uses a scratch file. If the -t option is specified, the file named 
in the next argument is used as the scratch file, if needed. 
Without the -t flag, fsck prompts the operator for the name 
of the scratch file. The file chosen should not be on the file 
system being checked, and if it is not a special file or did not 
already exist, it is removed when fsck completes. If the sys- 
tem has a large hard disk there may not be enough space on 
another filesystem for the scratch file. .In such cases, if the 
system has a floppy drive, use a blank, formatted floppy in 
the floppy drive with (for example) /dev/fd0 specified as the 
scratch file. 


Quiet fsck. Do not print size-check messages in Phase 1. 
Unreferenced fifoS files will selectively be removed. If fsck 
requires it, counts in the superblock will be automatically 
fixed and the free list salvaged. 


Directories are checked for bad blocks. Useful after system 
crashes. 


Fast check. Check block and sizes (Phase 1) and check the 
free list (Phase 5). The free list will be reconstructed (Phase 
6) if it is necessary. 


Recovers the root file system. The required filesystem argu- 
ment must refer to the root file system, and preferably to the 
block device (normally /dev/root). This switch implies -y 
and overrides -n . If any modifications to the file system are 
required, the system will be automatically shutdown to insure 
the integrity of the file system. 


Causes any supported file system to be converted to the type 
of the current file system. The user is prompted to verify the 
request for each file system that requires conversion unless 
the -y option is specified. It is recommended that every file 
system be checked with this option while unmounted if it is 
to be used with the current version of XENIX. To update 
the active root file system, it should be checked with: 


fsck -c —rr /dev/root 


If no file-systems are specified, fsck reads a list of default file sys- 
tems from the file /ete/checklist. 
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Inconsistencies checked are as follows: 
- Blocks claimed by more than one inode or the free list 


- Blocks claimed by an inode or the free list outside the range of 
the file system 


ae - Incorrect link counts 


- Size checks: 
Incorrect number of blocks 
Directory size not 16-byte aligned 


- Bad inode format 
- Blocks not accounted for anywhere 


- Directory checks: 
File pointing to unallocated inode 
Inode number out of range 


- Super-block checks: 
More than 65536 inodes 
More blocks for inodes than there are in the file system 


- Bad free block list format 
tor" - Total free block or free inode count incorrect 


Orphaned files and directories (allocated but unreferenced) are, 
with the operator’s concurrence, reconnected by placing them in 
the lost#found directory. The name assigned is the inode number. 
The only restriction is that the directory lost+found must preexist 
in the root of the file system being checked and must have empty 
slots in which entries can be made. This is accomplished by mak- 
ing lost+found, copying a number of files to the directory, and 
then removing them (before fsck is executed). 


Dfsck allows two file system checks on two different drives simul- 
taneously. Options] and options2 are used to pass options to fsck 
for the two sets of file systems. A - is the separator between file 
system groups. 

Files 
/etc/checklist Contains default list of file systems to check 

See Also 


checklist(F), filesystem(F) 
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Diagnostics 


The diagnostics produced by fsck are intended to be self- 
explanatory. 


Notes 


Fsck will not run on a mounted non-raw file system unless the file 
system is the root file system or unless the -n option is specified 
and no writing out of the file system will take place. If any such 
attempt is made, a warning is displayed and no further processing 
of the file system is done for the specified device. 


Although checking a raw device is almost always faster, there is no 
way to tell if the file system is mounted. And cleaning a mounted 
file system will almost certainly result in an inconsistent superblock. 


Warning 


File systems created under XENIX-86 version 3.0 are not supported 
under XENIX System V because the word ordering in type long 
variables has changed. Fsck is capable of auditing and repairing 
XENIX version 3.0 file systems if the word ordering is correct. 


For the root file system, “fsck -rr /dev/root” should be run and for 


all other file systems, “fsck /dev/??” on the unmounted block dev- 
ice should be used. 
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Name 


getopt — Parses command options. 


Syntax 


set —— ‘getopt optstring $*° 


Description 


Getopt is used to check and break up options in command lines for 
parsing by shell procedures. Optstring is a string of recognized 
option letters (see getopt(S)). If a letter is followed by a colon, the 
option is expected to have an argument which may or may not be 
separated from it by whitespace. The special option —— is used to 
delimit the end of the options. Getopt will place —— in the argu- 
ments at the end of the options, or recognize it if used explicitly. 
The shell arguments ($1 $2 . . .) are reset so that each option is pre- 
ceded by a dash (—) and in its own shell argument; each option 
argument is also in its own shell argument. 


Example 


The following code fragment shows how one can process the argu- 
ments for a command that can take the options a and b, and the 
option o, which requires an argument: 


set — — ‘getopt abo: $*s 

if [ $? != 0 | 

then 
echo $USAGE 
exit 2 

fi 

for i in $* 

do 
case $i in 
—a | -b) FLAG=$i; shift;; 
—-O) OARG=$2; shift; shift;; 
- -) shift; break;; 
esac 

done 


This code will accept any of the following as equivalent: 


cmd -aoarg file file 

cmd —a -o arg file file 
cmd -oarg —a file file 
cmd —a —oarg —— file file 
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See Also 


sh(C), getopt(S) 


Diagnostics 
Getopt prints an error message on the standard error when it 
encounters an option letter not included in optstring. 

Notes 


The “Syntax” given for this utility assumes the user has a sh(C) 
shell. 
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Name 


grep, egrep, fgrep — Searches a file for a pattern. 


Syntax 


grep [ options ] expression [ files | 


egrep [ options ] [ expression ] [ files ] 


fgrep [ options | [ strings | [ files ] 


Description 


Commands of the grep family search the input files (standard input 
default) for lines matching a pattern. Normally, each line found is 
copied to the standard output. Grep patterns are limited regular 
expressions in the style of ed(C); it uses a compact nondeterministic 
algorithm. Egrep patterns are full regular expressions; it uses a fast 
deterministic algorithm that sometimes needs exponential space. 
Fgrep patterns are fixed strings; it is fast and compact. The follow- 
ing options are recognized: 


my 


al 


—=S 


per 


All lines but those matching are displayed. 
Displays only exact matches of an entire line. (Fgrep only.) 
Only a count of matching lines 1s displayed. 


Only the names of files with matching lines are displayed, 
separated by newlines. 


Each line is preceded by its relative line number in the file. 
Each line is preceded by the block number on which it was 
found. This is sometimes useful in locating disk block 


numbers by context. 


Suppresses error messages produced for nonexistent or 
unreadable files. 


Turns on matching of letters of either case in the input so 
that case is insignificant. Does not work for egrep. 


—e expression 


Same as a simple expression argument, but useful when the 
expression begins with a dash (—). 
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—f file 
The regular expression for grep or egrep, or Strings list (for 
fgrep) is taken from the file. 


In all cases, the filename is output if there is more than one input 
file. Care should be taken when using the characters $, *, [, *, |, ( 
), and \in expression, because they are also meaningful to the shell. 
It is safest to enclose the entire expression argument in single quota- 
tion marks. 


Fgrep searches for lines that contain one of the strings separated by 
newlines. 


Egrep accepts regular expressions as in ed(C), except for \( and \), 
with the addition of the following: 


— A regular expression followed by a plus sign (+) matches one or 
more occurrences of the regular expression. 


— A regular expression followed by a question mark (?) matches 0 
or 1 occurrences of the regular expression. 


— Two regular expressions separated by a vertical bar (|) or by a 
newline match strings that are matched by either regular expres- 
sion. 


~ A regular expression may be enclosed in parentheses () for 
grouping. 


The order of precedence of operators is [ ], then *? +, then con- 
catenation, then the backslash (\) and the newline. 
See Also 


ed(C), sed(C), sh(C) 


Diagnostics 
Exit status is 0 if any matches are found, 1 if none, 2 for syntax 
errors or inaccessible files. 

Notes 


Ideally there should be only one grep, but there isn’t a single algo- 
rithm that spans a wide enough range of space-time tradeoffs. 


Lines are limited to 256 characters; longer lines are truncated. 
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Egrep does not recognize ranges, such as [az], in character 
classes. 


When using grep with the —y option, the search is not made totally 
case insensitive in character ranges specified within brackets. 


Multiple strings can be specified in fgrep without using a separate 
strings file by using the quoting conventions of the shell to imbed 
newlines in the single string argument. For example, you might 
enter the following on the command line: 


fgrep ‘string! 


string2 
string3’ text.file 


Similarly, multiple strings can be specified in egrep by doing: 
egrep ‘string!1|string2|string3 text. file 
Thus egrep can do almost anything that grep and frep can do. 
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Name 


grpcheck — Checks group file. 


Syntax 


grpcheck [file] 


Description 
Grpcheck verifies all entries in the group file. This verification 
includes a check of the number of fields, group name, group ID, 
and whether all login names appear in the password file. The 
default group file is /etc/group. 

Files 
/etc/group 


/etc/passwd 


See Also 


pwcheck(C), group(M), passwd(M) 


Diagnostics 


Group entries in /etc/group with no login names are flagged. 
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Name 


haltsys — Closes out the file systems and halts the CPU. 


Syntax 


/etc/haltsys 


Description 


Haltsys does a shutdn() system call (see shutdn(S)) to flush out 
pending disk I/O, mark the file systems clean, and halt the proces— 
sor. Haltsys takes effect immediately, so user processes should be 
killed beforehand. Shutdown(C) is recommended for normal sys— 
tem termination; it warns the users, cleans things up, and calls 
haltsys. Use haltsys directly only if some system problem prevents 
the running of shutdown. 


Notes 


haltsys locks hard disk heads. 


See Also 
shutdn(S), shutdown(C) 
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Name 


HD (C) 


hd — Displays files in hexadecimal format. 


Syntax 


hd [ —format [ —s offset ] [ —n count ] [ file ] ... 


Description 


The hd command displays the contents of files in hexadecimal, 
octal, decimal, and character formats. Control over the specifica- 
tion of ranges of characters is also available. The default behavior 
is with the following flags set: ‘“-abx -A”. This says that addresses 


(file offsets) 


and bytes are printed in hexadecimal and that charac- 


ters are also printed. If no file argument is given, the standard 


input is read. 


Options include: 


—s offset 


—n count 
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Specify the beginning offset in the file where printing 
is to begin. If no ‘file’ argument is given, or if a seek 
fails because the input is a pipe, ‘offset’ bytes are read 
from the input and discarded. Otherwise, a seek error 
will terminate processing of the current file. 


The offset may be given in decimal, hexadecimal (pre- 
ceded by ‘Ox’), or octal (preceded by a ‘0’). It is 
optionally followed by one of the following multipliers: 
w, l, b, or k; for words (2 bytes), long words (4 
bytes), half kilobytes (512 bytes), or kilobytes (1024 
bytes). Note that this is the one case where “b” does 
not stand for bytes. Since specifying a hexadecimal 
offset in blocks would result in an ambiguous trailing 
‘b’, any offset and multiplier may be separated by an 
asterisk (*). 


Specify the number of bytes to process. The count is 
in the same format as offset, above. 
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Format Flags 


Format flags may specify addresses, characters, bytes, words (2 
bytes) or longs (4 bytes) to be printed in hex, decimal, or octal. 
Two special formats may also be indicated: text or ascii. Format 
and base specifiers may be freely combined and repeated as desired 
in order to specify different bases (hexadecimal, decimal or octal) 
for different output formats (addresses, characters, etc.). All for- 
mat flags appearing in a single argument are applied as appropriate 
to all other flags in that argument. 


acbwiA 
Output format specifiers for addresses, characters, bytes, words, 
longs and ascii respectively. Only one base specifier will be used 
for addresses; the address will appear on the first line of output 
that begins each new offset in the input. 


The character format prints printable characters unchanged, 
special C escapes as defined in the language, and the remaining 
values in the specified base. 


The ascii format prints all printable characters unchanged, and 
all others as a period (.). This format appears to the right of the 
first of other specified output formats. A base specifier has no 
meaning with the ascii format. If no other output format (other 
than addresses) is given, bx is assumed. If no base specifier is 
given, all of xdo are used. 


hxdo 
Output base specifiers for hexadecimal, decimal and octal. If 
no format specifier is given, all of acbwl are used. 


t Print a text file, each line preceded by the address in the file. 
Normally, lines should be terminated by a \n character; but long 
lines will be broken up. Control characters in the range 0x00 to 
Oxlf are printed as “@’ to “_’. Bytes with the high bit set are 
preceded by a tilde (~) and printed as if the high bit were not 
set. The special charcters (*, ~, \) are preceded by a backslash 
(\) to escape their special meaning. As special cases, two values 
are represented numerically as ‘\177’ and ‘\377’. This flag will | 
override all output format specifiers except addresses. 
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Name 


head — Prints the first few lines of a stream. 


Syntax 


boas head [ —count | [ file... ] 


Description 
This filter prints the first count lines of each of the specified files. 


If no files are specified, head reads from the standard input. If no 
count is specified, then 10 lines are printed. 


See Also 


tail(C) 
Credit 


This utility was developed at the University of California at 
Berkeley and is used with permission. 
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Name 


id — Prints user and group IDs and names. 


Syntax 
id 


Description 
Id writes a message on the standard output, giving the user and 


group IDs and the corresponding names of the invoking process. If 
the effective and real IDs do not match, both are printed. 


See Also 


logname(C), getuid(S) 
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Name 


imprint — print text files on an IMAGEN printer 


Syntax 


imprint [ pr options ] [ options ] [ file... ] 


Description 

imprint calls pr or cat on the input files, and prepends a document 

control string for an IMAGEN printer. If no file names are given, 

the standard input is used. All options not listed below are 
regarded as options to pr or cat and are passed to it. The file is not 
automatically sent to the printer. The user must invoke lp. 

The following flags are accepted: 

-P Specifies that the file is text, and is printed in lineprinter mode. 
-D Specifies that the file is produced for a daisy printer. -t 
Specifies that the file is produced for a Tektronix 4014 printer. 

-I Specifies the file is an imPress file. 


-p The next argument is passed to pr or cat. 


Print n copies. This turns on pagecollation. 

-h The following argument is used as the banner for pr and as the 
file name for the header page of the job. Be sure to enclose the 
argument in quotes if it contains spaces or other special charac- 
ters. 


-In Set the page length to n lines. This may also set the printer’s 
interline spacing. 


-n Use cat rather than pr to print the file. 
-wn 
Set the the line width to nm characters. A line width of more 
than 80 characters is printed in landscape (132 column) mode. 
-2 Print two logical pages per physical page (“‘2-up’’). 
-C Suppress pagecollation (see -¢ above). 


-F Suppress pagereversal (which is on by default). 
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-J Suppress generation of the job header page. 
-L Print in landscape mode, 132 columns wide. 
-O Print page borders. 


-R Print page rules (one every two lines). 


See Also 
cat(C), Ip(C), pr(C), ips(C) 


Diagnostics 


See diagnostic messages for pr and cat. 
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Name 
ipcrm — Removes a message queue, semaphore set or shared 
memory ID. 
Syntax 


iperm [ options | 


Description 


Ipcrm removes one or more specified messages, a semaphore or 
shared memory identifiers. The identifiers are specified by the fol- 
lowing options: 


—q msqid 


—m shmid 


—s semid 


-Q msgkey 


—M shmkey 


—S semkey 


removes the message queue identifier msgid from the 
system and destroys the message queue and data struc- 
ture associated with it. 


removes the shared memory identifier shmid from the 
system. The shared memory segment and data struc- 
ture associated with it are destroyed after the last 
detach. 


removes the semaphore identifier semid from the sys- 
tem and destroys the set of semaphores and data 
structure associated with it. 


removes the message queue identifier, created with 
key msgkey, from the system and destroys the message 
queue and data structure associated with it. 


removes the shared memory identifier, created with 
key shmkey, from the system. The shared memory 
segment and data structure associated with it are des- 
troyed after the last detach. 


removes the semaphore identifier, created with key 
semkey, from the system and destroys the set of sema- 
phores and data structure associated with it. 


The details of the removes are described in msgctl(S), shmctl(S), 
and semctl(S). The identifiers and keys may be found by using 


ipcs(C). 


See Also 


ipcs(C), msgctl(S), msgget(S), msgop(S), semctl(S), semget(S), 
semop(S), shmctl(S), shmget(S), shmop(S) 
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Note 


Ipcrm cannot be used to remove semaphores created using 
creatsem(S) or to remove shared memory created using sdget(S). 
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Name 


ipcs — Reports the status of inter-process communication facilities. 


Syntax 


ipcs [ options | 


Description 


Ipcs prints certain information about active inter-process communi- 
cation facilities. Without options, information is printed in short 
format for message queues, shared memory, and semaphores that 
are currently active in the system. Otherwise, the information that 
is displayed is controlled by the following options: 


—q Print information about active message queues. 
—m Print information about active shared memory segments. 
—s Print information about active semaphores. 


If any of the options —q, —m, or —S are specified, information 
about only those indicated are displayed. If none of the three 
options are specified, information about all three are displayed. 


—b 
Print biggest allowable size information (maximum number of 
bytes in messages on queue for message queues, size of seg- 
ments for shared memory, and number of semaphores in each 
set for semaphores). See below, for the meaning of columns in 
a listing. 

=—C 
Print creator’s login name and group name. See below. 

—O 
Display information on outstanding usage (number of messages 
on queue, total number of bytes in messages on qucue, and the 
number of processes attached to shared memory segments). 
Display process number information. (Process ID of last pro- 
cess to send a message and process ID of last process to receive 
a message on message queues. It displays the process ID of the 
creating process and the process ID of the last process to attach 
or detach on shared memory segments.) See below. 

—t Print time information. (Time of the last control operation that 
changed the access permissions for all facilities. Time of last 
msgsnd and last msgrcv on message queues, last shmat and last 
shmat on shared memory, and last semop(S) on semaphores.) 
See below. 

—a 
Use all print options. (This is a shorthand notation for —b, —c, 
—0, —p, and —t.) 
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—C corefile 
Use the file corefile in place of /dev/kmem. 

—N namelist 
The argument will be taken as the name of an alternate namelist 
(/xenix is the default). 


The column headings and the meaning of the columns in an ipcs 
listing are given below; the letters in parentheses indicate the 
options that cause the corresponding heading to appear; all means 
that the heading always appears. Note that these options only 
determine what information is provided for each facility; they do 
not determine which facilities will be listed. 


T (all) Type of the facility: 
q message queue; 
m shared memory segment; 
S semaphore. 

ID (all) The identifier for the facility entry. Note that ID 
is ““X”’ for facilities created using creatsem(S) or 
sdget(S). 

KEY (all) The key used as an argument to msgget, semget, 
or shmget to create the facility entry. (Note: The 
key of a shared memory segment is changed to 
IPC_PRIVATE from when the segment has been 
removed until all processes attached to the seg- 
ment detach it.) 

MODE (all) The facility access modes and flags: The mode 
consists of 11 characters that are interpreted as 
follows: 

The first two characters are: 
' Rif a process is waiting on a msgrcv; 

S if a process is waiting on a msgsnd; 

D_ if the associated shared memory segment 
has been removed. It will disappear when 
the last process attached to the segment 
detaches it; 

C if the associated shared memory segment 
is to be cleared when the first attach is 
executed; 

— if the corresponding special flag is not set. 


The next 9 characters are interpreted as three sets 
of three bits each. The first set refers to the 
Owner’s permissions; the next to permissions of 
others in the user-group of the facility entry; and 
the last to all others. Within each set, the first 
character indicates permission to read, the second 
character indicates permission to write or alter the 
facility entry, and the last character is currently 
unused. 
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OWNER (all) 
GROUP (all) 
CREATOR(a,c) 
CGROUP (a,c) 
CBYTES (a,o) 
QNUM (a,0) 
QBYTES (a,b) 
LSPID = (a,p) 
LRPID (a,p) 
STIME  (a,t) 
RTIME  (a,t) 
CTIME (a,t) 
NATTCH (a,0) 
SEGSZ (a,b) 
CPID (ap) 
LPID (a,p) 
ATIME (a,t) 
DTIME (a,t) 
NSEMS (a,b) 
OTIME (a,t) 
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The permissions are indicated as follows: 


if read permission is granted; 

if write permission is granted; 

if alter permission is granted; 

if the indicated permission is not granted. 
The login name of the owner of the facility entry. 
The group name of the group of the owner of the 
facility entry. 

The login name of the creator of the facility entry. 
The group name of the group of the creator of the 
facility entry. 

The number of bytes in messages currently out- 
standing on the associated message queue. 

The number of messages currently outstanding on 
the associated message queue. 

The maximum number of bytes allowed in mes- 
sages outstanding on the associated message 
queue. 

The process ID of the last process to send a mes- 
sage to the associated queue. 

The process ID of the last process to receive a 
message from the associated queue. 

The time the last message was sent to the associ- 
ated queue. 

The time the last message was received from the 
associated queue. 

The time when the associated entry was created 
or changed. 

The number of processes attached to the associ- 
ated shared memory segment. 

The size of the associated shared memory seg- 
ment. 

The process ID of the creator of the shared 
memory entry. 

The process ID of the last process to attach or 
detach the shared memory segment. 

The time the last attach was completed to the 
associated shared memory segment. 

The time the last detach was completed on the 
associated shared memory segment. 

The number of semaphores in the set associated 
with the semaphore entry. 

The time the last semaphore operation was com- 
pleted on the set associated with the semaphore 
entry. 


pogn 
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Files 
/xenix system namelist 
/dev/‘kmem memory 


/etc/passwd user names 
/etc/group group names 


See Also 


creatsem(S), msgop(S), sdget(S), semop(S), shmop(S) 


Notes 


IPCS (C) 


Things can change while ipcs is running; the picture it gives is only 


a close approximation. 
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Name 


ips — Imagen serial sequence packet protocol handler 
ipbs— Imagen parallel byte stream protocol handler 


Syntax 


/usr/lib/ips [ -D string ] [ -a file | [ -1 file | [ -i printer | [-oprs] [ -u 
uid] [ file ] 


Description 


ips and ipbs are the lowest level of Imagen-provided support 
software. Each handles a different form of supported communica- 
tions. They present a quite similar view to higher level software, 
allowing that to be relatively independent of communications 
method. 


ips sends files to Imagen printers using the sequence packet proto- 
col (see the appropriate IMAGEN system manual for further infor- 
mation). This protocol provides for error detection, retransmis- 
sion, status reporting, and detection of unrecoverable errors. 


ipbs supports the parallel byte stream communications method, 

which provides for flow control but no error detection and correc- 

tion. 

The following information is common to all these programs. 

If no file name is given, stdin is read. 

The following options are recognized: 

-D The next argument is taken as a string to be prepended to the 
file being sent. If an unrecoverable failure occurs during 
transmission and the file can be resent, this string will be resent 


as well. 


-a The next argument is taken as the name of a file in which to 
store printer status information. 


-i The following argument is the device name of the printer. 


-1 The next argument is taken as the name of a file in which to 
store logging information. 


-o Normally ips expects to send to stdout and does not expect to 


have to set port characteristics. If an explicit device name is 
given with the -i switch, both of these assumptions are reversed. 
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-r 


-S 


This switch serves to toggle the assumption on the need to set 
up port characteristics. This switch does not apply to ipbs 
which does not set up its ports. 


If ips is given an explicit file name to send, it will assume the file 
to be rewindable. Stdin is assumed to be not rewindable. In a 
manner similar to the -o switch above, this switch toggles this 
assumption. 


Regardless of what other indications may have been given, use 
stdout as the printer. 


-uuid 


Uid is a string representing the user identification number of the 
person to be credited with this printing job. 


See Also 


imprint(C), Ip(C), Ipinit(C) 


Notes 


An interface for Imagen printers is found in the directory 
/usr/spool/Ip/model. The file imagen.s provides an interface to an 
Imagen printer in serial mode. The file imagen.p provides an inter- 
face to an Imagen printer in parallel mode. 


The /pinit program can be used to initialize an Imagen printer in 
either serial or parallel mode. 
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Name 


join — Joins two relations. 


Syntax 


join [ options ] file1 file2 


Description 


Join forms, on the standard output, a join of the two relations 
specified by the lines of filel and file2. If file] is a dash (—), the 
standard input is used. 


Filel and file2 must be sorted in increasing ASCII collating 
sequence on the fields on which they are to be joined, normally the 
first in each line. 


There is one line in the output for each pair of lines in filel and 
file2 that have identical join fields. The output line normally con- 
sists of the common field, then the rest of the line from filel, then 
the rest of the line from file2. 


Fields are normally separated by blank, tab or newline. In this 
case, multiple separators count as one, and leading separators are 
discarded. 


These options are recognized: 


—an In addition to the normal output, produces a line for 
each unpairable line in file n, where n is 1 or 2 


—es Replaces empty output fields by string S. 


—jnm Joins on the mth field of file n. If n is missing, uses the 
mth field in each file. 


—o list Each output line comprises the fields specifed in list, 
each element of which has the form n.m, where n is a 


file number and m is a field number. 


tc Uses character c as a separator (tab character). Every 
appearance of c in a line is significant. 
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See Also 


awk(C), comm(C), sort(C) 


Notes 


With default field separation, the collating sequence is that of sort 
—b. With —t, the sequence is that of a plain sort. 
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Name 


kill - Terminates a process. 


Syntax 


kill [ —signo ] processid ... 


Description 


Kill sends signal 15 (terminate) to the specified processes. This will 
normally kill processes that do not catch or ignore the signal. The 
process number of each asynchronous process started with & is 
reported by the shell (unless more than one process is started in a 
pipeline, in which case the number of the last process in the pipe- 
line is reported). Process numbers can also be found by using 


ps(C). 


For example, if process number 0 is specified, all processes in the 
process group are signaled. 


The killed process must belong to the current user unless he is the 
super-user. 


If a signal number preceded by — is given as the first argument, 
that signal is sent instead of the terminate signal (see signal(S)). In 
particular “kill -9 ...” is a sure kill. 


See Also 


ps(C), sh(C), kill(S), signal(S) 
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Name 


1 — Lists information about contents of directory. 


Syntax 


1{ —asdrucifg | name ... 


Description 


For each directory argument, / lists the contents of the directory; 
for each file argument, / repeats its name and other requested infor- 
mation. The output is sorted alphabetically by default. When no 
argument is given, the current directory is listed. When several 
arguments are given, the arguments are first sorted appropriately, 
but file arguments appear before directories and their contents. 
Information is listed in the format of the “Is —1” command, which 
‘s identical to the 1 command. This format and all provided 
switches are described in Is(C), to which should you should refer 
for a complete discussion of the capabilities of L. 


Files 
/etc/passwd Contains user IDs 


/etc/group Contains group IDs 


Notes 
Newline and tab are considered printing characters in filenames. 


The output device is assumed to be 80 columns wide. 
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Name 


lc — Lists directory contents in columns. 


Syntax 


Ie [ —1ACFRabcdfgilmngrstux | name ... 


Description 


Lc lists the contents of files and directories, in columns. If name is 
a directory name, Ic lists the contents of the directory; if name is a 
filename, Ic repeats the filename and any other information 
requested. Output is given in columns and sorted alphabetically. If 
no argument is given, the current directory is listed. If several 
arguments are given, they are sorted alphabetically, but file 
arguments appear before directories. 


Files that are not the contents of a directory being interpreted are 
always sorted across the page rather than down the page in 
columns. A stream output format is available in which files are 
listed across the page, separated by commas. The —m option 
enables this format. 


The options are: 


—1 
Forces an output format with one entry per line. 


—A 
If not the root directory, this option displays all files that begin 
with “.” (except “.” and “..” themselves). Otherwise, files are 
displayed normally. 


—C = 
Forces columnar output, even if redirected to a file. 


—F 
Causes directories to be marked with a trailing “/’” and 
executable files to be marked with a trailing “*”’. 


—R | 
Recursively lists subdirectories. 


—a 
Lists all entries; usually “‘.” and “‘..” are suppressed. 


—b 


Forces printing of nongraphic characters in the \ddd notation, 
in octal. - 
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—c 
Sorts by time of file creation. 


—d 
If the argument is a directory, lists only its name, not its 
contents (mostly used with —1 to get status on directory). 


—f Forces each argument to be interpreted as a directory and lists 
the name found in each slot. This option turns off —l, —t, —s, 
and —r, and turns on —a; the order is the order in which entries 
appear in the directory. 


The same as —1, except that the owner is not printed. 


—i Prints inode number in first column of the report for each file 
listed. 


—I Lists in long format, giving mode, number of links, owner, 
group, size in bytes, and time of last modification for each file. 
If the file is a special file, the size field instead contains the 
major and minor device numbers. 


—-oO 
The same as —1, except that the group is not printed. 


Forces stream output format. 


—n 
Same as the —I switch, but the owner’s user ID appears instead 
of the owner’s name. If used in conjunction with the —g 
switch, the owner’s group ID appears instead of the group 
name. 


—q 
Forces printing of nongraphic characters in filenames as the 
character “‘?”’, 


—r 
Reverses the order of sort to get reverse alphabetic or oldest 
first as appropriate. 


—s 
Gives size in 512-byte blocks, including indirect blocks for each 
entry. 


—t Sorts by time modified (latest first) instead of by name, as is 
normal. 
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—uU 
Uses time of last access instead of last modification for sorting 
(—t) or printing (—1). 

=X 
Forces columnar printing to be sorted across rather than down 
the page. 

The following are alternate invocations of the le command: 

If Produces the same output as le -F. 

Ir Produces the same output as le -R. 


Ix Produces the same output as le -x. 


The mode printed under the —1 option contains 11 characters. The 
first character is: 


— If the entry is a plain file 

d If the entry is a directory 

b_ If the entry is a block-type special file 

c If the entry is a character-type special file 

p If the entry is a named pipe 

s If the entry is a semaphore 

m If the entry is shared data (memory) 

The next 9 characters are interpreted as 3 sets of 3 bits each. The 
first set refers to owner permissions; the next to permissions to 
others in the same user-group; and the last to all others. Within 
each set, the 3 characters indicate permission respectively to read, 
to write, or to execute the file as a program. For a directory, 
“execute” permission is interpreted to mean permission to search 
the directory for a specified file. The permissions are indicated as 
follows: 

r If the file is readable 

w If the file is writable 


x If the file is executable 


— If the indicated permission is not granted 


August 26, 1985 | Page 3 


LC) LC(€) 


The group-execute permission character is given as s if the file has 
set-group-ID mode; likewise the user-execute permission character 
is given as s if the file has set-user-ID mode. 


The last character of the mode (normally “x” or “—”) is t if the 
1000 bit of the mode is on. See chmod(C) for the meaning of this 
mode. 


When the sizes of the files in a directory are listed, a total count of 
blocks, including indirect blocks, is displayed. 


Files 
/etc/passwd To get user IDs for “Ic —1’’ 


/etc/‘group To get group IDs for “‘Ic -g” 


Credit 


This utility was developed at the University of California at 
Berkeley and is used with permission. 


Notes 


Newline and tab are considered printing characters in filenames. 
The output device is assumed to be 80 columns wide. Column 
width choices are poor for terminals that can tab. 


This utility reports sizes in 512 byte blocks. On systems which use 
1024 byte blocks, this means a file of 500 bytes uses 2 blocks. Ic -s 
will report 2 blocks used, rather than 1 block, since the file uses 
one system block of 1024 bytes. Refer to the machine(M) manual 
page for the block size used by your system. 
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Name 


line — Reads one line. 


Syntax 


line 


Description 
Line copies one line (up to a newline) from the standard input and 
writes it on the standard output. It returns an exit code of 1 on 


end-of-file and always prints at least a newline. It is often used 
within shell files to read from the user’s terminal. 


See Also 
gets(CP), sh(C) 
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Name 


In — Makes a link to a file. 


Syntax 


In file1 file2 
In filel ... directory 


Description 
A link is a directory entry referring to a file; the same file (together 
with its size, all its protection information, etc). may have several 
links to it. There is no way to distinguish a link to a file from its 
original directory entry. Any changes to the file are effective 
independent of the name by which the file is known. 


In the first case, Jn creates a link to the existing file, filel. The file2 
argument is a new name referring to the same file contents as file/. 


In the second case, directory is the location of a directory into 
which one or more links are created with corresponding file names. 


You cannot link to a directory or link across file systems. 


See Also 
ep(C), mv(C), rm(C) 
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Name 


logname — Gets login name. 


Syntax 


logname 
Description 


Logname returns the value of getlogin (S) or getuid(S) which is set 
when a user logs into the system. 


See Also 


env(C), getlogin(S), getuid(S), login(M), logname(S) 
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Name 


Ip, lpr, cancel — Send/cancel requests to lineprinter. 


Syntax 


Ip [options...][name...] 

or 

Ipr (options... ][name...] 

cancel [ request ID s ] [ printers | 


Description 


Ip causes the named files and associated information (collectively 
called a “request’”) to be printed by a lineprinter. /p and lpr are 
equivalent commands and may be used interchangeably. If no file 
names are mentioned, the standard input is assumed. The file 
name - stands for the standard input and may be supplied on the 
command line in conjunction with named files. The order in which 
files appear is the same order in which they will be printed. 


Ip associates a unique request ID with each request and prints it on 
the standard output. This request ID can be used later to cancel 
(see cancel) or find the status of the request (see Ipstat(C)). 


The following options to Jp may appear in any order and may be 
intermixed with file names: 


-C Makes copies of the files to be printed immediately 
when Jp is invoked. Normally, files will not be copied, 
but will be linked whenever possible. If the -c option 
is not given, then the user should be careful not to 
remove any of the files before the request has been 
printed in its entirety; any changes made to the named 
files after the request is made but before it is printed 
will be reflected in the printed output. 


-ddest Chooses dest as the printer or class of printers to do 
the printing. If dest is a printer, then the request will 
be printed only on that specific printer. If dest is a 
class of printers, then the request will be printed on the 
first available printer that is a member of the class. 
Under certain conditions (for example, printer unavai- 
lability or file space limitation), requests for specific 
destinations may not be accepted (see accept(C) and 
Ipstat(C)). By default, dest is taken from the environ- 
ment variable LPDEST (if it is set). Otherwise, a 
default destination (if one exists) for the computer sys- 
tem is used. Destination names vary between systems 
(see Ipstat(C)). 
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-m Sends mail (see mail(C)) after the files have been 
printed. By default, no mail is sent upon normal com- 
pletion of the print request. 


-nnumber Prints number of copies of the output. The default is 
one. 


-ooption Specifies printer-dependent or class-dependent options. 
Several such options may be collected by specifying the 
-o keyletter more than once. For more information 
about what is valid for options, see Ilpadmin(C). 


-r Removes file after sending it. 

-S Suppresses messages from /p(C) such as “request id is 
>] 

-ttitle Prints title on the banner page of the output. 

-w Writes a message on the user’s terminal after the files 


have been printed. If the user is not logged in, then 
mail is sent instead. 


The file /etc/default/Ipd contains the setting of the variable 
BANNERS, whose value is the number of pages printed as a banner 
identifying each printout. This is normally set to either 1 or 2. 


Cancel cancels line printer requests that were made by the /p(C) 
command. The command line arguments may be either request IDs 
(as returned by /p(C)) or printer names (for a complete list, use 
Ipstat(C)). Specifying a request ID cancels the associated request 
even if it is currently printing. Specifying a printer cancels the 
request which is currently printing on that printer. In either case, 
the cancellation of a request that is currently printing frees the 
printer to print its next available request. User’s identification and 
accounting data spool area contains BANNERS setting. 


Files 
/etc/passwd 


/usr/spool/|p/* 
/etc/default/lpd 


See Also 
enable(C), Ipstat(C), mail(C), accept(C), lpadmin(C), Ipsched(C) 
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Name 


lpadmin — Configures the lineprinter spooling system. 


Syntax 


/usr/lib/lpadmin -p printer [ options... | 
/usr/lib/lpadmin -x dest 
/usr/lib/Ipadmin -d([dest] 


Description 


Ipadmin configures the lineprinter spooling system to describe 
printers, classes, and devices. It is used to add and remove desti- 
nations, change membership in classes, change devices for printers, 
change printer interface programs, and to change the system default 
destination. System managers may also use [pinit(C) to add new 
printing destinations to the system. /padmin may not be used when 
the lineprinter scheduler, Ipsched(C), is running, except where 
noted below. 


Exactly one of the -p, -d, or -x options must be present for every 
legal invocation of /padmin. 


-d[dest| Makes dest, an existing destination, the new system 
default destination. If dest is not supplied, then there 
is no system default destination. This option may be 
used when Ipsched(C) is running. No other options 
are allowed with -d. 


-xdest Removes destination dest from the LP system. If dest 
is a printer and is the only member of a class, then the 
class will be deleted, too. No other options are 
allowed with -x. 


-pprinter Names a printer to which all of the options below 
refer. If printer does not exist then it will be created. 


The following options are only useful with -p and may appear in any 
order. For ease of discussion, the printer will be referred to as p 
below. 


-cclass Inserts printer p into the specified class. Class will be 
created if it does not already exist. 


-eprinter Copies an existing printer’s interface program to be the 
new interface program for p. 
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-h Indicates that the device associated with p _ is 
hardwired. This option is assumed when creating a 
new printer unless the -l option is supplied. 


-linterface Establishes a new interface program for p. Interface is 
the pathname of the new program. 


-| Indicates that the device associated with p is a login 
terminal. The lineprinter scheduler, lpsched(C), dis- 
ables all login terminals automatically each time it is 
started. Before re-enabling p, its current device should 
be established using /padmin. 


-mmodel The model printer interface program, dumb, is sup- 
plied with XENIX lineprinter software. It is a shell 
procedure which interfaces Ipsched(C) and print dev- 
ices. It can be found in _ the _ directory 
/usr/spool/lp/model and may be used as is with lpad- 
min -m or Ipinit(C). This program is an interface for a 
line printer without special functions and protocol. 
Form feeds are assumed. System managers may 
modify copies of dumb and then use lpadmin -i to 
associate the copies with printers. 


-rclass Removes printer p from the specified class. If p is the 
last member of the class, then the class will be 
removed. 

-vdevice Associates a new device with printer p. Device is the 


pathname of a file that is wmtable by the system 
manager, /p. Note that there is nothing to stop a sys- 
tem manager from associating the same device with 
more than one printer. If only the -p and -v options 
are supplied, then /padmin may be used while the 
scheduler is running. 


Restrictions 


When creating a new printer, the -v option and one of the -e, -i, or 
-m options must be supplied. Only one of the -e, -i, or -m options 
may be supplied. The -h and -l keyletters are mutually exclusive. 
Printer and class names may be no longer than 14 characters and 
must consist entirely of the characters A-Z,a-z,0O-9 and _ 
(underscore). 


Models 
Model printer interface programs are shell procedures which inter- 


face between Ipsched(C) and devices. Models reside in the direc- 
tory /usr/spool/Ip/model and may be used as is with /padmin -m. 
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Models should have 644 permission if owned by Jp & bin, or 664 
permission if owned by bin & bin. System managers may modify 
copies of models and then use /padmin -i to associate them with 
printers. If printers have special options, these can be included in 
the interface program. Users can then choose an option with the 
lp -o command. 


One model interface program is supplied with XENIX lineprinter 
software: dumb. This is an interface program for a lineprinter 
without special functions and protocol. Form feeds are assumed. 
This is a good model for system managers to copy and modify. 
Serial printers that need delays or other special stty(C) options 
(such as maping CR to newline) should have this string included in 
the model interface program: 
stty [ options ... |] 0<&1 
Files 


/usr/spool/Ip/* 


See Also 


accept(C), enable(C), Ip(C), Ipinit(C), Ipsched(C), Ipstat(C) 
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Name 


Ipinit — Adds new lineprinters to system. 


Syntax 


/etc/lpinit 


Description 


Lpinit is a shell script for configuring and adding new lineprinters to 
a system. It should only be executed by the system manager. 
Lpinit asks a series of questions for which the default answers are 
displayed. The system manager can enter a response or press the 
RETURN key for the default answer. If the system manager enters 
H in response to the first question, a help message is displayed. 
Lpinit prompts users for the following information: 


~ The print device pathname (default is /dev/Ip). 
~ The name of the printer (default is linepr ). 


~ The pathname of the printer interface program (default is 
/usr/spool/lp/model/dumb). 


The printer name can be any combination of up to 14 alphanumeric 
characters or underscores. A printer interface program can be a 
shell script, C program, or any executable program; or the model 
interface program, /usr/spool/Ip/model/dumb, can be copied and 
modified. (See the section “Models” on the manual page 
Ipadmin(C).) 


After the system manager has responded to these questions, 
/etc/ lpinit stops the print scheduler lpsched, changes the acceptance 
status of the new lineprinter to ‘‘accept,” and enables it to print 
files. /Etc/lpinit then asks if the new printer will be the default 
printing destination (default is yes). All nonspecific print requests 
are routed to the default destination (see /p(C)). 


The steps to configure a new printer can be taken separately, (see 


lpadmin(C), accept(C), enable(C), and Ipsched(C) for more infor- 
mation). 
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Files 


/etc/lpinit 


See Also 


accept(C), enable(C), Ip(C), lpadmin(C), Ipsched(C) ina 


August 26, 1985 Page 2 


LPR (C) LPR (C) 


Name 


lpr — Sends files to the lineprinter queue for printing. 


Syntax 


Ipr [ option ... ] [ name ... | 


Description 
Lpr causes the named files to be queued for printing on a line- 
printer. If no names appear, the standard input is assumed; thus 
lpr may be used as a filter. 


The following options may be given (each as a separate argument 
and in any order) before any filename arguments: 


=C¢ Makes a copy of the file and prints the copy and not the 
original. Normally files are linked whenever possible. 


=—r Removes the file after sending it. 
—m _ When printing is complete, reports that fact by mail(C). 


—n Does not report the completion of printing by mail(C). 
This is the default option. 


The file /etc/default/Ipd contains the setting of the variable 
BANNERS, whose value is the number of pages printed as a banner 
identifying each printout. This is normally set to either 1 or hs 


Files 
/etc/passwd User’s identification and accounting data 
/usr/lib/\pd Lineprinter daemon 
/usr/spool/Ipd/* Spool area 
/etc/default/Ipd Contains BANNERS default setting 
/etc/lpopen On some systems - sets modes on a serial line 
See Also 
banner(C) 
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Notes 


Once a file has been queued for printing, it should not be changed 
or deleted until printing is complete. If you want to alter the con- 
tents of the file or to remove the file immediately, use the —c 
option to force /pr to make its own copy of the file. 
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Name 


Ipsched, Ipshut, Ipmove — Starts/stops the lineprinter request 
scheduler and moves requests. 


Syntax 


/usr/lib/Ipsched 

/usr/lib/ipshut 

/usr/lib/Ipmove requests destinations 
/usr/lib/Ipmove dest1 dest2 


Description 


Ipsched schedules requests taken by Ip(C) for printing on line- 
printers. 


Ipshut shuts down the lineprinter scheduler. All printers that are 
printing at the time /pshut is invoked will stop printing. Requests 
that were printing at the time a printer was shut down will be 
reprinted in their entirety after Ipsched is started again. All line- 
printer commands perform their functions even when Ipsched is not 
running. 


Ipmove moves requests that were queued by /p(C) between line- 
printer destinations. This command may be used only when 
Ipsched is not running. The first form of the command moves the 
named requests to the lineprinter destinations, dest. Requests are 
request IDs as returned by Ip(C). The second form moves all 
requests for destination dest1 to destination dest2. As a side effect, 
Ip(C) will reject requests for dest. 

Note that Ipmove never checks the acceptance status for the new 
destination when moving requests (see accept(C)). 

Files 


/usr/spool/|p/* 


See Also 
accept(C), enable(C), Ip(C), Ipadmin(C), Ipinit(C), Ipstat(C) 
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Name 


lpstat — prints lineprinter status information 


Syntax 


Ipstat [ options... | 


Description 


Ipstat prints information about the current status of the lineprinter 
system. 


If no options are given, then Jpstat prints the status of all requests 
made to Ip(C) by the user. Any arguments that are not options are 
assumed to be request IDs (as returned by Ip). Ipstat prints the 
status of these requests. Options may appear in any order and may 
be repeated and intermixed with other arguments. Some of the fol- 
lowing options may be followed by list that can be in one of two 
forms: a list of items separated from one another by a comma, or a 
list of items enclosed in double quotes and separated from one 
another by a comma and/or one or more spaces. For example: 


-u“‘userl, user2, user3” 


The omission of a list following such options causes all information 
relevant to the option to be printed, for example: 


Ipstat -o 
prints the status of all output requests. 
-a[list] Prints acceptance status (with respect to Jp) of destina- 
tions for requests. List is a list of intermixed printer 


names and class names. 


-c[list] Prints class names and their members. List is a list of 
class names. 


-d Prints the system default destination for Ip. 


-o[ list] Prints the status of output requests. List is a list of inter- 
mixed printer names, class names, and request IDs. 


-p[list] Prints the status of printers. List is a list of printer 


names. 
-r Prints the status of the lineprinter scheduler, lpsched. 
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-S Prints a status summary, including the status of the line- 
printer scheduler, the system default destination, a list of 
class names and their members, and a list of printers and 
their associated devices. 


-t Prints all status information. 


-u[list] Prints status of output requests for users. List is a list of 
login names. 


-v[Jist] Prints the names of printers and the pathnames of the 
devices associated with them. List is a list of printer 


names. 
Files 

/usr/spool/|p/* 
See Also 


enable(C), Ip(C) 
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Name 


ls - Gives information about contents of directories. 


Syntax 


Is [ -RadCxmlnogrtucpFbqisf ] [ names ] 


Description 


For each directory named, /s lists the contents of that directory; for 
each file named, Js repeats its name and any other information 
requested. By default, the output is sorted alphabetically. When 
no argument is given, the current directory is listed. When several 
arguments are given, the arguments are first sorted appropriately, 
but file arguments are processed before directories and their con- 
tents. 


There are three major listing formats. The default format is to list 
one entry per line, the -C and -x options enable multi-column for- 
mats, and the -m option enables stream output format in which 
files are listed across the page, separated by commas. In order to 
determine output format for the -C, -x, and -m options, ls uses an 
environment variable, COLUMNS, to determine the number of char- 
acter positions available on one output line. If this variable is not 
set, the termcap database is used to determine the number of 


columns, based on the environment variable TERM. If this infor- 
mation-cannot be obtained, 80 columns are assumed. 


There are many options: 
-R_ Recursively lists subdirectories encountered. 


-a__ Lists all entries; usually entries whose names begin with a 
period (.) are not listed. 


-d If an argument is a directory, lists only its name (not its con- 
tents); often used with -I to get the status of a directory. 


-C. Multi-column output with entries sorted down the columns. 


-x Multi-column output with entries sorted across rather than 
down the page. 


-m Stream output format. 
-| Lists in long format, giving mode, number of links, owner, 
group, size in bytes, and time of last modification for each file 


(see below). If the file is a special file, the size field will con- 
tain the major and minor device numbers, rather than a size. 
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-Uu 


-C 


-p 


-F 


-b 


“q 


-i 


-S 


-f 


LS (C) 


The same as -l, except that the owner’s UID and group’s GID 
numbers are printed, rather than the associated character 
strings. 

The same as -l, except that the group is not printed. 


The same as -l, except that the owner is not printed. 


Reverses the order of sort to get reverse alphabetic or oldest 
first, as appropriate. 


Sorts by time modified (latest first) instead of by name. 


Uses time of last access instead of last modification for sorting 
(with the -t option) or printing (with the -I option). 


Uses time of last modification of the inode (file created, mode 
changed, etc.) for sorting (-t) or printing (-l). 


Puts a slash (/) after each filename if that file is a directory. 


Puts a slash (/) after each filename if that file is a directory 
and puts an asterisk (*) after each filename if that file is exe- 
cutable. 


Forces printing of non-graphic characters to be in the octal 
\ddd notation. 


Forces printing of non-graphic characters in file names as the 
character (?). 


For each file, prints the inode number in the first column of 
the report. 


Gives size in blocks, including indirect blocks, for each entry. 


Forces each argument to be interpreted as a directory and lists 
the name found in each slot. This option turns off -l, -t, -s, 
and -r, and turns on -a; the order is the order in which 
entries appear in the directory. 


The mode printed under the -l option consists of 11 characters. 
The first character is: 


If the entry is an ordinary file. 


d= If the entry is a directory. 


b If the entry is a block special file. 
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c If the entry is a character special file. 
p___If the entry is a named pipe. 

s If the entry is a semaphore. 

m_ If the entry is a shared data (memory) file. 


The next 9 characters are interpreted as 3 sets of 3 bits each. The 
first set refers to the owner’s permissions; the next to permissions 
of others in the user-group of the file; and the last to all others. 
Within each set, the 3 characters indicate permission to read, to 
write, and to execute the file as a program, respectively. For a 
directory, “execute” permission is interpreted to mean permission 
to search the directory for a specified file. 


The permissions are indicated as follows: 

r If the file is readable. 

w If the file is writable. 

x If the file is executable. 

- If the indicated permission is not granted. 


The group-execute permission character is given as s if the file has 
set-group-ID mode; likewise, the user-execute permission character 
is given as s if the file has set-user-ID mode. The last character of 
the mode (normally x or -) is t if the 1000 (octal) bit of the mode is 
on; see chmod(C) for the meaning of this mode. The indications 
of set-ID and 1000 bit of the mode are capitalized if the 
corresponding execute permission is not set. 


When the sizes of the files in a directory are listed, a total count of 
blocks including indirect blocks is printed. 


Files 
/etc/passwd Gets user IDs for ls -l and ls -o 
/etc/group Gets group IDs for Is -1 and Is -g 


/etc/termcap/* Gets terminal information 


See Also 
chmod(C), find(C), 1(C), 1c(C), termcap(C) 
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Notes 
Newline and tab are considered printing characters in filenames. 


Unprintable characters in filenames may confuse the columnar out- 
put options. 


This utility reports sizes in 512 byte blocks. On systems which use 
1024 byte blocks, this means a file of 500 bytes uses 2 blocks. Is -s 
will report 2 blocks used, rather than 1 block, since the file uses 
one system block of 1024 bytes. Refer to the machine(M) manual 
page for the block size used by your system. 
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Name 


mail — Sends, reads or disposes of mail. 


Syntax 
mail [[-u user] [-f mailbox]] [-e] [-R] [-i] [ users ...] 


mail [-s subject] [-i] [ user ...] 


Description 


Mail is a mail processing system that supports composing of mes- 
sages, and sending and receiving of mail between multiple users. 
When sending mail, a user is the name of a user or of an alias 
assigned to a machine or to a group of users. 


Options include: 


-u user 
Tells mail to read the system mailbox belonging to the specified 
user. 


-f mailbox 
Tells mail to read the specified mailbox instead of the default 
user’s system mailbox. 


-e Allows escapes from compose mode when input comes from a 
file. 


-R Makes the mail session “read-only” by preventing alteration of 
the mailbox being read. Useful when accessing system-wide 
mailboxes. 


-i Tells mail to ignore interrupts sent from the terminal. This is 
useful when reading or sending mail over telephone lines where 
“noise” may produce unwanted interrupts. 


-s subject 
Specifies subject as the text of the Subject: field for the message 


being sent. 


Sending mail 


To send a message to one or more other people, invoke mail with 
arguments which are the names of people to send to. You are then 
expected to type in your message, followed by a Ctrl-D at the begin- 
ning of a line. 
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Reading Mail 


To read mail, invoke mail with no arguments. This will check your 
mail out of the system-wide directory so that you can read and 
dispose of the messages sent to you. A message header is printed 
out for each message in your mailbox The current message is ini- 
tially the last numbered message and can be printed using the print 
command (which can be abbreviated p). You can move among the 
messages much as you move between lines in ed, with the com- 
mands + and - moving backwards and forwards, and simple 
numbers typing the addressed message. 


If new mail arrives during the mail session, you can read in the new 
messages with the restart command. 


Disposing of Mail 


After examining a message, you can delete (d) the message or reply 
(r) to it. Deletion causes the mail program to forget about the mes- 
sage. This is not irreversible, the message can be undeleted (u) by 
giving its number, or the mail session can be aborted by giving the 
exit (x) command. Deleted messages will, however, disappear. 


Specifying Messages 


Commands such as print and delete often can be given a list of 
message numbers as arguments to apply to a number of messages at 
once. Thus “delete 1 2” deletes messages 1 and 2, while “delete 1- 
5” deletes messages 1 through 5. The special name ‘‘*” addresses 
all messages, and “$” addresses the last message; thus the com- 
mand top which prints the first few lines of a message could be 
used in “top *” to print the first few lines of all messages. 


Replying to or Originating Mail 


You can use the reply command to set up a response to a message, 
sending it back to the person who sent it. Then you can enter in 
the text of the reply, and press Ctrl-D to send it. While you are 
composing a message, mail treats lines beginning with a tilde (~) as 
special. For instance, typing ““m” alone on a line, places a copy of 
the current message into the response, right shifting it by one 
tabstop. Other escapes set up subject fields, add and delete reci- 
pients to the message, and allow you to escape to an editor to 
revise the message or to a shell to run some commands. (These 
options are given in the summary below.) 
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Ending a Mail Session 


You can end a mail session with the quit (q) command. Messages 
that have been examined go to your mbox file unless they have 
been deleted, in which case they are discarded. Unexamined mes- 
sages go back to the post office. The -f option causes mail to read 
in the contents of your mbox (or the specified file) for processing; 
when you quit, mail writes undeleted messages back to this file. 
The -i option causes mail to ignore interrupts. 


Using Aliases and Distribution Lists 


It is also possible to create a personal distribution list. For 
instance, you can send mail to “cohorts” and have it go to a group 
of people. Such lists can be defined by placing a line like 


alias cohorts bill bob barry bobo betty beth bobbi 


in the file .mailrc in your home directory. The current list of such 
aliases can be displayed by the alias (a) command in mail. 
System-wide distribution lists can be created by editing 
/usr/lib/mail/aliases, see aliases(M); these are kept in a slightly 
different syntax. In mail you send, personal aliases will be 
expanded in mail sent to others so that they will be able to reply to 
the recipients. System-wide aliases are not expanded when the mail 
is sent, but any reply returned to the machine will have the system- 
wide alias expanded. 


Mail has a number of options which can be set in the .mailrc file to 
alter its behavior; thus “set askcc”’ enables the “askcc” feature. 
(These options are summarized below.) 


Summary 


Each mail command is entered on a line by itself, and may take 
arguments following the command word. The command need not 
be entered in its entirety; the first command which matches the 
typed prefix is used. For the commands that take message lists as 
arguments; if no message list is given, then the next message for- 
ward that satisfies the command’s requirements is used. If there are 
no messages forward of the current message, the search proceeds 
backwards, and if there are no messages at all, mail types “‘No 
applicable messages” and aborts the command. 


Goes to the previous message and prints it out. If 


given a numeric argument 7, goes to the nth previous 
message and prints it. 
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+ 


RETURN 


alias 


Alias users 


cd 


delete 


dp 


echo path 


edit 


exit 
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Goes to the next message and prints it out. If given a 
numeric argument 7, goes to the nth next message and 
prints it. 


Goes to the next message and prints it out. 
Prints a brief summary of commands. 
Executes the shell command which follows. 
Prints out the current message number. 
Prints out the first message. 

Prints out the last message. 


(a) With no arguments, prints out all currently-defined 
aliases. With one argument, prints out that alias. 
With more than one argument, adds the users named 
in the second and later arguments to the alias named 
in the first argument. 


Prints system-wide list of aliases for users. At least 
one user must be specified. 


(c) Changes the user’s working directory to that 
specified, if given. If no directory is given, then 
changes to the user’s login directory. 


(d) Takes a list of messages as an argument and marks 
them all as deleted. Deleted messages are not 
retained in the system mailbox after a quit, nor are 
they available to any command other than the undelete 
command. 


Deletes the current message and prints the next mes- 
sage. If there is no next message, mail says “no more 
messages.” 


Expands shell metacharacters. 

(e) Takes a list of messages and points the text editor 
at each one in turn. On return from the editor, the 
message is read back in. 

(x) Effects an immediate return to the shell without 
modifying the user’s system mailbox, his mbox file, or 
his edit file in -f. 


(fi) Prints the name of the file mail is reading. If it is a 
mailbox, the name of the owner is returned. 
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forward 


Forward 


headers 


hold 


list 


Ipr 


mail 


mbox 
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(f) Forwards the current message to the named users. 
Current message is indented within forwarded mes- 
sage. 


(F) Forwards the current message to the named users. 
Current message is not indented within forwarded 
message. 


(h) Lists the current range of headers, which is an 18 
message group. If a “+” argument is given, then the 
next 18 message group is printed, and if a “-” argu- 
ment is given, the previous 18 message group is 
printed. Both “+” and “-” may take a number to view 
a particular window. If a message-list is given, it 
prints the specified headers. 


(ho) Takes a message list and marks each message 
therein to be saved in the user’s system mailbox 
instead of in mbox. Use only when the switch autom- 
box is set. Does not override the delete command. 


Prints list of mail commands. 


(1) Prints out each message in a message-list on the 
lineprinter. 


(m) Takes as arguments login names and distribution 
group names and sends mail to those people. 


(mb) Marks messages in a message list so that they are 
saved in the user mailbox after leaving mail. 


move mesg-list mesg-num 


next 


print 


quit 
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Places the messages specified in mesg-list after the 
message specified in mesg-num. If mesg-num is 0, 
mesg-list moves to the top of the mailbox. 


(n like + or RETURN) Goes to the next message in 
sequence and prints it. With an argument list, types 
the next matching message. 


(p) Prints out each message in a message-list on the 
terminal display. 


(q) Terminates the session, retaining all undeleted, 
unsaved messages in the system mailbox and removing 
all other messages. Files marked with a star (*) are 
saved; files marked with an “‘M” are saved in the user 
mailbox. If new mail has arrived during the session, 
the message “You have new mail” is given. If given 
while editing a mailbox file with the -f flag, then the 
mailbox file is rewritten. The user returns to the shell, 
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reply 


Reply 


restart 


Save 


set 


Shell 


size 


source 
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unless the rewrite of the mailbox file fails, in which 
case the user can escape with the exit command. 


(r) Takes a message list and sends mail to each mes- 
Sage author. The default message must not be 
deleted. 


(R) Takes a message list and sends mail to each mes- 
sage author and each member of the message just like 
the mail command. The default message must not be 
deleted. 


Reads in messages that arrived during the current mail 
session. 


(s) Takes a message list and a filename and appends 
each message in turn to the end of the file. The 
filename, in quotation marks, followed by the line 
count and character count is echoed on the user’s ter- 
minal. 


(se) With no arguments, prints all variable values. 
Otherwise, sets option. Arguments are of the form 
“option=value” or “option”. 


(sh) Invokes an interactive version of the shell. 


(si) Takes a message list and prints out the size in 
characters of each message. 


(so) Reads mail commands from the file given as its 
only argument. 


string string mesg-list 


top 


undelete 


unset 


visual 
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Searches for string in mesg-list. If no mesg-list is 
specified, all undeleted messages are searched. Case is 
ignored in search. 


(t) Takes a message list and prints the top few lines of 
each. The number of lines printed is controlled by the 
variable toplines and defaults to six. 


(u) Takes a message list and marks each one as not 
being deleted. 


(uns) Takes a list of option names and discards their 
remembered values; the inverse of set. 


(v) Takes a message list and invokes vi on each mes- 
sage. 
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Looks up a list of target mail recipients and prints the 
real names or descriptions of each recipient. If the 
first character of the first argument is alphabetic, the 
arguments are looked up without change. Otherwise, 
the arguments are assumed to be a message list, in the 
format specified in the Mail User’s Guide. For each 
message in the list, the “From” person is extracted 
from the header and added to the list of users to be 
searched. 


If a target mail recipient contains a machine and user 
name, nothing is printed. If it is a private alias, 
“private alias” is printed. If it is a global alias, the 


name or description of the recipient is printed (con- 


tents of the $n field in the alias file). If all of the 
above fail, the user is looked up in /etc/passwd; if the 
user is a local user, “local user” is printed. Finally, if 
none of the above tests and searches succeed, “‘unk- 
nown”’ is printed. 


write filename 


(w) Saves the body of the message in the named file. 


Here is a summary of the compose escapes, which are used when 
composing messages to perform special functions. Compose 
escapes are only recognized at the beginning of lines. 


~ string 


~“tcmd 


~| cmd 


Inserts the string of text in the message prefaced by a 
single tilde (~). If you have changed the escape charac- 
ter, then you should double that character instead. 


Prints out help for compose escapes. 
Same as Ctrl-D on a new line. 


Executes the indicated shell command, then returns to 
the message. 


Pipes the message through the command as a filter. If 
the command gives no output or terminates abnor- 
mally, retains the original text of the message. 


~_ mail-command 


Executes a mail command, then returns to compose 
mode. 


~: mail-command 
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Executes a mail command, then returns to compose 
mode. 
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“alias 
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Prints list of private aliases 


“alias aliasname 


“Alias 


“Alias users 


“h 


“m mesg-list 


“M mesg-list 
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Prints names included in private aliasname. 


Performs aliasing by first examining private aliases and 
then system-wide aliases using all three global alias 
files (aliases.hash, faliases, and maliases). Only the 
final result is printed (non-local mail recipients will 
have the complete delivery path printed). The user 
list is taken from header fields. 


Performs aliasing by first examining private aliases and 
then system-wide aliases using all three global alias 
files (aliases.hash, faliases, and maliases). Only the 
final result is printed (non-local mail recipients will 
have the complete delivery path printed). At least one 
user must be specified. 


Adds the given names to the list of blind carbon copy 
recipients. 


Adds the given names to the list of carbon copy reci- 
pients. 


_ Same as “c above. 


Reads the file dead.letter from your home directory 
into the message. 


Invokes the text editor on the message collected so 
far. After the editing session is finished, you may 
continue appending text to the message. 


Edits the message header fields by typing each one in 
turn and allowing the user to append text to the end 
or modify the field with the current terminal erase and 
kill characters. 


Reads the named messages into the message buffer, 
shifted right one tab. If no messages are specified, 
reads the current message. 


Reads the named messages into the message buffer, 
with no indentation. If no messages are specified, 
reads the current message. 


Prints out the messages collected so far, prefaced by 
the message header fields. 
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Prints the real names or descriptions (in parentheses) 
after each recipient in a header field. 


Aborts the message being sent, copying the message 
to dead.letter in your home directory if save is set. 


Reads the named file into the message buffer. 


“Return name 


“s string 


“t name ... 


v 


“w filename 


Options are 


Adds the given names to the Return-receipt-to field. 


Causes the named string to become the current sub- 
ject field. 


Adds the given names to the direct recipient list. 
Invokes a visual editor (defined by the VISUAL 
option) on the message buffer. After you quit the edi- 
tor, you may resume appending text to the end of your 
message. 


Writes the body of the message to the named file. 


controlled with the set and unset commands. An 


option may be either a switch, in which case it is either on or off, 
or a string, in which case the actual value is of interest. The switch 
options include the following: 


askcce 


asksubject 


autombox 


autoprint 


chron 


dot 
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Causes you to be prompted for additional carbon 
copy recipients at the end of each message. 
Responding with a newline indicates your satisfac- 
tion with the current list. 


Causes mail to prompt you for the subject of each 
message you send. If you respond with simply a 
newline, no subject field is sent. 


Causes all examined messages to be saved in the 
user mailbox unless deleted or saved. 


Causes the delete command to behave like dp - 
thus, after deleting a message, the next one will be 
entered automatically. 


Causes messages to be displayed in chronological 
order. 


Permits use of dot (.) as the end of file character 
when composing messages. 
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execmail 


ignore 


mchron 


metoo 


nosave 


quiet 


verify 
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Causes the underbar prompt to return before mail 
is finished being sent. This frees the user to con- 
tinue while mail performs mailing functions in 
background. 


Causes interrupt signals from your terminal to be 
ignored and echoed as at-signs (@). 


Causes messages to be listed in numerical order 
(most recently received first), but displayed in 
chronological order. 


Usually, when a group is expanded that contains 
the sender, the sender is removed from the expan- 
sion. Setting this option causes the sender to be 
included in the group. 


Prevents aborted messages from being appended to 
the file dead.letter in your home directory on 
receipt of two interrupts (or a ~q). 


Suppresses the printing of the version header when 
first invoked. 


Causes each target mail recipient to be verified in 
the manner decribed in the whois command. This 
option permits errors made while composing mes- 
sages to be corrected or ignored. 


The following options have string values: 


EDITOR 


SHELL 


VISUAL 


escape 


page=n 


record 
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Pathname of the text editor to use in the edit com- 
mand and “e escape. If not defined, then a default 
editor (/bin/ed ) is used. 


Pathname of the shell to use in the ! command and 
the ~! escape. A default shell (/bin/sh) is used if 
this option is not defined. 


Pathname of the text editor (/bin/vi) to use in the 
visual command and ‘v escape. 


If defined, the first character of this option gives 
the character to use in the place of the tilde (~) to 
denote escapes. 


Specifies the number of lines (7) to be printed in a 
“page” of text when displaying messages. 


If defined, gives the pathname of the file used to 


record all outgoing mail. If not defined, then out- 
going mail is not saved. 
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toplines If defined, gives the number of lines of a message 
to be printed out with the top command; normally, 
the first six lines are printed. 


Files 
/usr/spool/mail/* System mailboxes 
/usr/name/dead.letter File where undeliverable mail is depo- 
sited 
/usr/name/mbox Your old mail 
/usr/name/.mailrc File giving initial mail commands 
/usr/lib/mail/aliases System-wide aliases 


/usr/lib/mail/aliases.hash System-wide alias database 
/usr/lib/mail/faliases Forwarding aliases for the local machine 
/usr/lib/mail/maliases Machine aliases 
/usr/lib/mail/mailhelp.cmd Help file 

/usr/lib/mail/mailhelp.esc Help file 


/usr/lib/mail/mailhelp.set Help file 


/usr/lib/mail/mailrc System initialization file (defaults) 
/usr/bin/mail The mail command 
See Also 


aliases(M), aliashash(M), netutil(C) 
Credit 


This utility was developed at the University of California at 
Berkeley and is used with permission. 
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Name 


mesg — Permits or denies messages sent to a terminal. 


Syntax 


mesg[n][y | 


Description 
Mesg with argument n forbids messages via write(C) by revoking 
nonuser write permission on the user’s terminal. Mesg with argu- 
ment y reinstates permission. All by itself, mesg reports the 
current state without changing it. 


Files 


/dev/tty* 


See Also 


write(C) 


Diagnostics 


Exit status is 0 if messages are receivable, 1 if not, 2 on error. 
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Name 


mkdev - Calls scripts to create devices 


Syntax 


/etc/mkdev Ip 
/etc/mkdev hd 
/etc/mkdev serial 
/etc/mkdev fs [device file] 


Description 


mkdev calls the scripts to create the requested type of device file(s). 
mkdev calls either /pinit(C), hdinit, serinit, or fsinit. If no argu- 
ments are listed, mkdev prints a usage message. 


/etc/mkdev Ip creates device files for use with line printers. 


/etc/mkdev hd creates device files for use with peripheral hard 
disks. The device files for an internal hard disk already exist. 


/etc/mkdev serial creates device files for use with serial cards. The 
device files for the first and second ports already exist. Additional 
device files must be created for the ports added when expansion 
cards are added to the system. 


/etc/mkdev fs performs the system maintenance tasks required to 
add a new filesystem to the system once the device is created 
(mknod(C)) and the filesystem is made (mkfs(C)). It creates the 
/fie and “/file/lost&found directories, reserves slots in the 
lost&found directory, and modifies /etc/checklist and /etc/re to 
check (fsck(C)) and mount (mount(C)) the filesystem as appropn- 
ate. It is usually used in conjunction with mkdev hd when adding a 
second hard disk to the system, but can be used on any additional 
filesystem (for example, on a large internal hard disk or a floppy.) 


The various init scripts prompt for the information necessary to 
create the devices. 
Files 
/etc/hdinit 
/etc/\pinit 


/etc/serinit 
/etc/fsinit 
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See Also 


Ipinit(C), hd(M), Ip(M), serial(M) 
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Name 


mkdir — Makes a directory. 


Syntax 


mkdir dirname ... 


Description 


Mkdir creates directories. The standard entries “dot” (.), for the 
directory itself, and “dot dot” (..), for its parent, are made 
automatically. 


Mkdir requires write permission in the parent directory. The per- 
missions assigned to the new directory are modified by the current 
file creation mask set by umask (C). 


See Also 


rmdir(C), umask(C) 


Diagnostics 


Mkdir returns exit code 0 if all directories were successfully made; 
otherwise, it prints a diagnostic and returns nonzero. 
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Name 


mkfs — Constructs a file system. 


Syntax 


/etc/mkfs [ -y ] [ -n ] special blocks[ : inodes] [gap blocks] 
/etc/mkfs [ -y | [ -n | special proto [gap blocks] 


Description 


Mkfs constructs a file system by writing on the special file special , 
according to the directions found in the remainder of the command 
line. 


If it appears that the special file contains a file system, operator 
confirmation is requested before overwriting the data. The -y ‘ves 
option overrides this, and writes over any existing data without 
question. The -n option causes mkfs to terminate without question 
if the target contains an existing file system. The check used is to 
read block one from the target device (block one is the super- 
block) and see whether the bytes are the same. If they are not, this 
is taken to be meaningful data and confirmation is requested. 


If the second argument is given as a string of digits, mkfs builds a 
file system with a single empty directory on it. The size of the file 
system is the value of blocks interpreted as a decimal number. The 
boot program is left uninitialized. If the number of inodes is speci- 
fied, then this number should be the same as the estimated number 
of files in the file system. If the optional number of inodes is not 
given, the number of inodes is calculated as a function of the sys- 
tem file size. 


If the second argument is a file name that can be opened, mkfs 
assumes it to be a prototype file proto, and takes its directions 
from that file. The prototype file contains tokens separated by 
spaces or newlines. The first token is the name of a file to be — 
copied onto block zero as the bootstrap program. The bootstrap 
program specified should already be stripped of the header (see 
strip(CP)). If the header has not be stripped from the bootstrap 
program, then mkfs issues a warning. The second token is a 
number specifying the size of the created file system. Typically, it 
will have been the number of blocks on the device, perhaps dimin- 
ished by space for swapping. The next token is the i-list size in 
blocks. The next set of tokens comprise the specification for the 
root file. File specifications consist of tokens giving the mode, the 
user ID, the group ID, and the initial contents of the file. The syn- 
tax of the contents field depends on the mode. 
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The mode token for a file is a 6 character string. The first charac- 
ter specifies the type of the file. (The characters -bed specify regu- 
lar, block special, character special and directory files respectively.) 
The second character of the type is either u or - to specify set-user- 
ID mode or not. The third is g or - for the set-group-ID mode. 
The rest of the mode is a three digit octal number giving the owner, 
group, and other read, write, execute permissions; see chmod (C). 


Two decimal number tokens come after the mode; they specify the 
user and group ID’s of the owner of the file. 


If the file is a regular file, the next token is a pathname whose con- 
tents and size are copied. If the file is a block or character special 
file, two decimal number tokens follow which give the major and 
minor device numbers. If the file is a directory, mkfs makes the 
entries . and .. and then reads a list of names and (recursively) file 
specifications for the entries in the directory. The scan is ter- 
minated with the token $. 


A sample prototype specification follows: 


/stand/diskboot 

4872 110 

d-—777 3 1 

usr d—7773 1 
sh —755 3 1 /bin/sh 
ken d—755 61 

$ 

bO b-—644 3 
cO c—6443 
$ 


100 
100 


$ 
In both commands, the disk interleaving factors, gap and blocks , 
can be specified. The interleaving factors are a disk hardware func- 
tion and are described in detail in the XENIX Operations Guide. 
See Also 
chmod(C), filesystem(F), dir(F), strip(CP) 


Notes 
There is no way to specify links when using a prototype file. If the 


number of inodes is specified on the command line, then the max- 
imum number of inodes in the file system is 65500. 


August 26, 1985 Page 2 


om 


MKNOD (C) MKNOD (C) 


Name 


mknod — Builds special files. 


Syntax 
/etc/mknod name [ c || b |] major minor 
/etc/mknod name p 
/etc/mknod name s 


/etc/mknod name m 


Description 


Mknod makes a directory entry and corresponding inode for a spe- 
cial file. The first argument is the name of the entry. In the first 
case, the second argument is b if the special file is block-type 
(disks, tape) or ¢c if it is character-type (other devices). The last 
two arguments are numbers specifying the major device type and 
the minor device (e.g., unit, drive, or line number), which may be 
either decimal or octal. 


The assignment of major device numbers is specific to each system. 
Major device numbers can be found in the system source file c.c. 


Mknod can also be used to create named pipes with the p option; 
semaphores with the s option; and shared data (memory) with the 
m option. 


Only the super-user can use the first form of the syntax. 


System Compatibility 
The s and m options can only be used to create XENIX version 3.0 


semaphores and shared data, not XENIX System V semaphores and 
shared data. 


See Also 


mknod(S) 


August 26, 1985 Page 1 


MKUSER (C) MKUSER (C) 


Name 


mkuser — Adds a login ID to the system. 


Syntax 


/etc/mkuser 


Description 


mkuser is used to add more user login IDs to the system. It is the 
preferred method for adding new users to the system, since it han- 
dles all directory creation and password file update. To add a new 
user to the system, mkuser requires five pieces of information: the 
login name, the initial password, the group identification, the user’s 
login shell and an optional comment string for the password file. It 
also allows the new user to be assigned to a group if required, 
although in most cases a default group is suitable. The program 
prompts for these five items and validates the given data. The login 
name is checked against certain criteria (i.e., it must be at least 
three characters and begin with a lowercase letter). The password 
must follow standard XENIX conventions, see passwd(C). The 
password file comment field can be up to 20 characters of informa- 
tion. 


Mkuser takes some of its parameters from a default file, 
/etc/default/mkuser. Currently, one may set the root path of home 
directories. An example default file is: 


HOME=/usr 


This file can be edited (by the super-user) to change this default. 
There are five other files in the directory /usr/lib which may also be 
altered to suit local options. They are mkuser.help which is the 
introductory explanation given by mkuser on startup, mkuser.mail 
which is the initial mail message sent to new users, mkuser.prof, the 
standard .profile file given to new sh and rsh shell users, 
mkuser.login, the standard .login file given to new csh users, and 
mkuser.cshrc, the standard .cshrc file given to new csh users. 


Mkuser prompts for the shell type to assign to the new user. The 
shell types available are standard (Bourne) sh (option 1), visual 
shell vsh (option 2), c-shell csh (option 3), restricted rsh (option 4), 
and uucp login (option 5). 


Mkuser allocates user IDs starting at 200, or the largest number 
used in the password file. The default group ID for new users is 50. 
The minimum group ID allowed for user accounts is 50. The pro- 
gram prompts the operator for an optional group specification. 
This can either be a numeric group ID, or a group name. If the 
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group exists, the user is added to it. If it does not exist, a new entry 
in /etc/group is created. A new group cannot have a numeric ID 
less than 51. If a new group is to be created, and the operator only 
specifies the group name, a free group ID is assigned. Alternatively, 
the operator can specify the group ID too. 
Mkuser can only be executed by the super-user. 
The minimum length of a legal password, and the minimum and 
maximum number of weeks used in password aging are specified in 
/etc/default/passwd by the variables PASSLENGTH, MINWEEKS 
and MAXWEEKS. For example, these variables might be set as fol- 
lows: 

PASSLENGTH=6 

MINWEEKS=2 

MAXWEEKS=6 

Files 

/etc/passwd 
/usr/spool/mail/username 
/etc/default/mkuser 
/usr/lib/mkuser.cshre 
/usr/lib/mkuser. help 
/usr/lib/mkuser. login 
/usr/lib/mkuser.prof 


/usr/lib/mkuser. mail 


See Also 


chmod(C), group(M), passwd(C), pwadmin(C), rmuser(C) 
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Name 


more - Views a file one screen full at a time. 


Syntax 


more [ -cdflsur ] [ -7 | [ +/inenumber | [| +/pattern || name ... ] 


Description 


This filter allows examination of a continuous text one screen full at 
a time. It normally pauses after each full screen, displaying: 


—More— 


at the bottom of the screen. If the user then presses a carriage 
return, one more line is displayed. If the user presses the SPACE 
bar, another full screen is displayed. Other possibilities are 
described below. 


The command line options are: 


-H 


=¢ 


-d 


-f 


| 


An integer which is the size (in lines) of the window which more 
will use instead of the default. 


More draws each page by beginning at the top of the screen and 
erasing each line just before it draws on it. This avoids scrolling 
the screen, making it easier to read while more is writing. This 
option is ignored if the terminal does not have the ability to 
clear to the end of a line. 


More prompts with the message “Hit space to continue, Rubout 
to abort" at the end of each full screen. This is useful if more is 
being used as a filter in some setting, such as a class, where 
many users may be inexperienced. 


This option causes more to count logical, rather than screen 
lines. That is, long lines are not folded. This option is recom- 
mended if nroff output is being piped through ul, since the latter 
may generate escape sequences. These escape sequences con- 
tain characters that would ordinarily occupy screen positions, 
but do not print when they are sent to the terminal as part of an 
escape sequence. Thus more may think that lines are longer 
than they actually are and fold lines erroneously. 


Does not treat Ctrl-L (form feed) specially. If this option is not 
given, more pauses after any line that contains a Ctrl-L, as if the 
end of a full screen has been reached. Also, if a file begins with 
a form feed, the screen is cleared before the file is printed. 
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-s Squeezes multiple blank lines from the output, producing only 
one blank line. Especially helpful when viewing nroff output, 
this option maximizes the useful information present on the 
screen. 


-u Normally, more handles underlining, such as that produced by 
nroff in a manner appropriate to the particular terminal: if the 
terminal can perform underlining or has a stand-out mode, more 
outputs appropriate escape sequences to enable underlining or 
stand-out mode for underlined information in the source file. 
The -u option suppresses this processing. 


-r Normally, more ignores control characters that it does not inter- 
pret in some way. The -r option causes these to be displayed as 
°C where “‘C”’ stands for any such character. 


-w Normally, more exits when it comes to the end of its input. With 
-w however, more prompts and waits for any key to be struck 
before exiting. 


+linenumber 
Starts up at linenumber. 


+/pattern 
Starts up two lines before the line containing the regular expres- 
sion pattern. 


More looks in the file /etc/termcap to determine terminal charac- 
teristics, and to determine the default window size. On a terminal 
capable of displaying 24 lines, the default window size is 22 lines. 


More looks in the environment variable MORE to preset any flags 
desired. For example, if you prefer to view files using the -ec mode 
of operation, the shell command ‘“MORE=-c” in the .profile file 
causes all invocations of more to use this mode. 


If more is reading from a file, rather than a pipe, a percentage is 
displayed along with the ““—-More—” prompt. This gives the fraction 
of the file (in characters, not lines) that has been read so far. 


Other sequences which may be entered when more pauses, and 
their effects, are as follows (i is an optional integer argument, 
defaulting to 1): 


1 <space> 
Displays i more lines, (or another full screen if no argument is 
given). 


Ctrl-D 


Displays 11 more lines (a “‘scroll”’). If iis given, then the scroll 
size is set tol. 
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d Same as Ctrl-D. 

iz Same as entering a space except that i, if present, becomes the 
new window size. 

is Skips i lines and displays a full screen of lines. 

if Skips i full screens and displays a full screen of lines. 

qorQ 
Exits from more. 

= Displays the current line number. 

v Starts up the screen editor vi at the current line. Note that wi 
may not be available with your system. 

h or ? 
Help command; Gives a description of all the more commands. 

i /expr 
Searches for the ith occurrence of the regular expression expr. 
If there are less than i occurrences of expr, and the input is a 
file (rather than a pipe), then the position in the file remains 
unchanged. Otherwise, a full screen is displayed, starting two 
lines before the place where the expression was found. The 
user’s erase and kill characters may be used to edit the regular 
expression. Erasing back past the first column cancels the 
search command. 

in Searches for the ith occurrence of the last regular expression 
entered. 

> (Single quotation mark) Goes to the point from which the last 
search started. If no search has been performed in the current 
file, this command goes back to the beginning of the file. 

!command 
Invokes a shell with command. The characters % and ! in 
“command” are replaced with the current filename and the pre- 
vious shell command respectively. If there is no current 
filename, % is not expanded. The sequences “\%” and “\!” are 
replaced by ‘“%” and “‘!” respectively. 

en 


Skips to the ith next file given in the command line (skips to 
last file if n doesn’t make sense). 
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iD 
Skips to the ith previous file given in the command line. If this 
command is given in the middle of printing out a file, more goes 
back to the beginning of the file. If i doesn’t make sense, more 
Skips back to the first file. If more is not reading from a file, 
the bell rings and nothing else happens. 

:-{ Displays the current filename and line number. 


:q or :Q 
Exits from more (same as q or Q). 


Repeats the previous command. 
The commands take effect immediately. It is not necessary to enter 
a carriage return. Up to the time when the command character 
itself is given, the user may enter the line kill character to cancel 
the numerical argument being formed. In addition, the user may 
enter the erase character to redisplay the “—~More—(xx% )” message. 
The terminal is set to noecho mode by this program so that the out- 
put can be continuous. What you enter will not show on your ter- 
minal, except for the slash (/) and exclamation (!) commands. 
If the standard output is not a teletype, more acts just like cat, 
except that a header is printed before each file (if there is more 
than one). 
A sample usage of more in previewing nroff output would be 


nroff -ms +2 doc.n | more -s 


Files 
/etc/termcap Terminal data base 


/usr/lib/more.help Help file 


See Also 
csh(CP), sh(C), environ(M) 


Credit 


This utility was developed at the University of California at Berke- 
ley and is used with permission. 
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Notes 
The vi and help options may not be available. 


Before displaying a file, more attempts to detect whether it is a 
non-printable binary file such as a directory or executable binary 
image. If more concludes that a file is unprintable, it refuses to 
print it. However, more cannot detect all possible kinds of non- 
printable files. 
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Name 


mount — Mounts a file structure. 


Syntax 
/etc/mount [ special-device directory [ -r ]] 


/etc/umount special-device 


Description 


Mount announces to the system that a removable file structure is 
present on special-device. The file structure is mounted on direc- 
tory. The directory must already exist; it becomes the name of the 
root of the newly mounted file structure. directory should be 
empty. If directory contains files, they will appear to have been 
removed while the directory is mounted and reappear when the 
directory is unmounted. 


The mount and umount commands maintain a table of mounted 
devices. If each special device is invoked without any arguments, 
mount displays the name of the device, and the directory name of 
the mounted file structure, whether the file structure is read-only, 
and the date it was mounted. 
The optional last argument indicates that the file is to be mounted 
read-only. Physically write-protected file structures must be 
mounted in this way or errors occur when access times are updated, 
whether or not any explicit write is attempted. 
Umount removes the removable file structure previously mounted 
on device special-device. 

Files 


/etc/mnttab Mount table 


See Also 


umount(C), mount(S), mnttab(F) 
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Diagnostics 


Mount issues a warning if the file structure to be mounted is 
currently mounted under another name. 


Busy file structures cannot be dismounted with umount. A file 
Structure is busy if it contains an open file or some user’s working 
directory. 


Notes 


Some degree of validation is done on the file structure, however it 
is generally unwise to mount corrupt file structures. 


Be warned that when in single-user mode, the commands that look 
in /ete/mnttab for default arguments (for example df, ncheck, 
quot, mount, and umount) give either incorrect results (due to a 
corrupt /etc/mnttab from a non-shutdown stoppage) or no results 


(due to an empty mnttab from a shutdown stoppage). 


When multi-user, this is not a problem; /etc/rc initializes 
/etc/mnttab to contain only /dev/root and subsequent mounts 
update it appropriately. 


The mount(C) and umount(C) commands use a lock file to guaran- 
tee exclusive access to /ete/mnttab. The commands which just 
read it (those mentioned above) do not, so it is possible that they 
may hit a window, which is corrupt. This is not a problem in prac- 
tice since mount and umount are not frequent operations. 


When mounting a file system on a floppy disk you need not use the 
Same directory each time. However, if you do, the full pathnames 
for the files are consistent with each use. 


Floppy disks must be unprotected (no write-protect tab) to be 
mounted as a filesystem. Always unmount filesystems on floppy 
disks before removing them from the floppy drive. Failure to do so 
requires running fsck the next time the disk is mounted . 
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Name 


mv — Moves or renames files and directories. 


Syntax 
mv filel file2 


my file ... directory 


Description 
Mv moves (changes the name of) file/ to file2. 
If file2 already exists, it is removed before filel is moved. If file2 
has a mode which forbids writing, mv prints the mode (see 
chmod (S)) and reads the standard input to obtain a line. If the line 
begins with y, the move takes place; if not, mv exits. 


In the second form, one or more files are moved to the directory 
with their original filenames. 


My refuses to move a file onto itself. 


See Also 
cp(C), chmod(S), copy(C) 


Notes 


If filel and file2 lie on different file systems, mv must copy the file 
and delete the original. In this case the owner name becomes that 
of the copying process and any linking relationship with other files 
is lost. 
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Name 


ncheck — Generates names from inode numbers. 


Syntax 


ncheck [ —i numbers ] [ —a][—s ] [ file-system ] 


Description 


Ncheck with no argument generates a pathname and inode number 
list of all files on the set of file systems specified in /etc/mnttab. 
The two characters ‘‘/.” are appended to the names of directory 
files. The —i option reduces the report to only those files whose 
inode numbers follow. The —a option allows printing of the names 
. and .., which are ordinarily suppressed. The —s option reduces 
the report to special files and files with set-user-ID mode; it is 
intended to discover concealed violations of security policy. A sin- 
gle filesystem may be specified rather than the default list of 
mounted file systems. 


Files 


/etc/mnttab 


See Also 
fsck(C), sort(C) 


Diagnostics 
When the file system structure is improper, ?? denotes the “parent” 
of a parentless file and a pathname beginning with ... denotes a 
loop. 

Notes 


See Notes under mount(C). 
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Name 


netutil — Administers the XENIX network. 


Syntax 


netutil [ —option | 


Description 


The netutil command allows the user to create and maintain a net- 
work of XENIX machines. A Micnet network is a link through 
serial lines of two or more XENIX systems. It is used to send mail 
between systems with the mail(C) command, transfer files between 
systems with the rcp(C) command, and execute commands from a 
remote system with the remote(C) command. 


The netutil command is used to create and distnbute the data files 
needed to implement the network. It is also used to start and stop 
the network. The option argument may be any one of install, save, 
restore, start, stop, or the numbers 1 through 5 respectively. 


The install option interactively creates the data files needed to run 
the network. The save option saves these files on floppy or hard 
disks, allowing them to be distributed to the other systems in the 
network. If you save the micnet files to the hard disk, you can 
then use uucp(C) to transfer the files to the other machines. This 
option specifies the name of the backup device and prompts for 
whether this is the desired device to use. The user can specify an 
alternate device, including a file on the hard disk. The name of the 
default backup device is located in the file /etc/default/micnet. 
This can be changed depending on system configuration. The 
restore option copies the data files from floppy disk back to a sys- 
tem. The start option starts the network. The stop option stops 
the network. An option may also be any decimal digit in the range 
1 to 5. If invoked without an option, the command displays a 
menu from which to choose one. Once an option is selected, it 
prompts for additional information if needed. 
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A network must be installed before it can be started. Installation 
consists of creating appropriate configuration files with the install 
option. This option requires the name of each machine in the net- 
work, the serial lines to be used to connect the machines, the 
speed of transmission for each line, and the names of the users on 
each machine. Once created, the files must be distributed to each 
computer in the network with the save and restore options. The 
network is started by using the start option on each machine in the 
network. Once started, mail and remote commands can be passed 
along the network. A record of the transmissons between comput- 
ers in a network can be kept in the network log files. Installation 
of the network is described in the XENIX Operations Guide. 


Files 
/bin/netutil 
/etc/default/micnet 
See Also 
aliases(M), aliashash(M), mail(C), micnet(M), remote(C), rcp(C), 


systemid(M), top(M) 
XENIX Operations Guide 
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Name 


newform — Changes the format of a text file. 


Syntax 


newform [-s] [-itabspec] [-otabspec] [-bn] [-en] [-pn] [-an] [-f] 
[-cchar] [-In] [file ... ] 


Description 


Newform reads lines from the named files, or the standard input if 
no input file is named, and reproduces the lines on the standard 
output. Lines are reformatted in accordance with command line 
options in effect. 


Except for -s, command line options may appear in any order, may 
be repeated, and may be intermingled with files. Command line 
options are processed in the order typed. This means that option 
sequences like ‘“‘-e15 -160” will yield results different from “-160 - 
e15”. Options are applied to all files on the command line. 


-itabspec Input tab specification: expands tabs to spaces, accord- 
ing to the tab specifications given. Tabspec recognizes 
all tab specification forms described below. In addition, 
tabspec may be --, in which newform assumes that the 
tab specification is to be found in the first line read from 
the standard input. If no tabspec is given, tabspec 
defaults to -8. A tabspec of -0 expects no tabs; if any 
are found, they are treated as -1. 


-otabspec Output tab specification: replaces spaces by tabs, 
according to the tab specifications given. The tab 
specifications are the same as for -itabspec. If no 
tabspec is given, tabspec defaults to -8. A tabspec of -0 
means that no spaces will be converted to tabs on out- 
put. 


-ln Sets the effective line length to n characters. If n is not 
typed, -] defaults to 72. The default line length without 
the -1 option is 80 characters. Note that tabs and back- 
spaces are considered to be one character (use -i to 
expand tabs to spaces). 


-bn Truncates n characters from the beginning of the line 
when the line length is greater than the effective line 
length (see -Im). The default is to truncate the number 
of characters necessary to obtain the effective line 
length. The default value is used when -b with no 7 is 
used. This option can be used to delete the sequence 
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numbers from a COBOL program as follows: 
newform -l11 -b7 file-name 


The option -I1 must be used to set the effective line 
length shorter than any existing line in the file so that the 
| -b option is activated. 


-en Truncates n characters from the end of the line. 


-ck Changes the prefix/append character to k. Default char- 
acter for k is a space (see options -p and -c). 


-pn Prefixes n characters (see -ck) to the beginning of a line 
when the line length is less than the effective line length. 
The default is to prefix the number of characters neces- 
sary to obtain the effective line length. 


-an Appends n characters to the end of a line. The default 
is to append the number of characters necessary to get 
the effective line length. 


-f Writes the tab specification format line on the standard 
output before any other lines are output. The tab 
specification format line which is printed will correspond 
to the format specified in the Jast -o option. If no -o 
option is specified, the line which is printed will contain 
the default specification of -8. 


-S Shears off leading characters on each line up to the first 
tab and places up to 8 of the sheared characters at the 
end of the line. If more than 8 characters (not counting 
the first tab) are sheared, the eighth character 1S 
replaced by a * and any characters to the right of it are 
discarded. The first tab is always discarded. 


An error message and program exit will occur if this 
option is used on a file without a tab on each line. The 
characters sheared off are saved internally until all other 
options specified are applied to that line. The charac- 
ters are then added at the end of the processed line. 


Tabs 


Four types of tab specification are accepted for tabspec: “canned,”’ 
repetitive, arbitrary, and file. The lowest column number is 1. For 
tabs, column 1 always refers to the leftmost column on a terminal, 
even one whose column markers begin at 0, e.g. the DASI 300, 
DASI 300S, and DASI 450. 
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The “canned” tabs are given as -code where code (and its meaning) 
is from the following list: 


-a 


-a2 


“¢ 


-f 


-p 


-S 


-Uu 


1,10, 16,36,72 
Assembler, IBM S/370, first format 


1,10,16,40,72 
Assembler, IBM S/370, second format 


1,8,12,16,20,55 
COBOL, normal format 


1,6,10,14,49 
COBOL compact format (columns 1-6 omitted). Using 
this code, the first typed character corresponds to card 
column 7, one space gets you to column 8, and a tab 
reaches column 12. Files using this tab setup should 
include a format specification as follows: 

<:t-c2 m6 s66 d:> 


1,6, 10,14, 18,22, 26,30,34,38,42,46,50,54,58,62,67 
COBOL compact format (columnms 1-6 omitted), with 
more tabs than COBOL -c2. This is the recommended 
format for COBOL. The appropriate format 
specification is: 

<:t-c3 m6 s66 d:> 


LY ALAS 23 
FORTRAN 


1,5,9,13,17,21,25,29,33,37,41,45,53,57,61 
PL/I 


1,10,55 
SNOBOL 


1,12,20,44 
UNIVAC 1100 Assembler 


In addition to these “canned” formats, three other types exist: 


“1 


A repetitive specification requests tabs at columns 1+n, 
1+2*n, etc. Note that such a setting leaves a left margin 
of n columns on TermiNet terminals only. Of particular 
importance is the value -8: this represents the XENIX 
system ‘“‘standard” tab setting, and is the most likely tab 
setting to found at a terminal. It is required for use with 
nroff(CT) -h option for high-speed output. Another 
special case is the value -0, implying no tabs at all. 
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ni1,n2,... The arbitrary format permits the user to type any chosen 
set of number, separated by commas, in ascending 
order. Up to 40 numbers are allowed. If any number 
(except the first one) is preceded by a plus sign, it is 
taken as an increment to be added to the previous value. 
Thus, the tab lists 1,10,20,30 and 1,10,+10,+10 are con- 
sidered identical. 


- -file 
If the name of a file is given, newform reads the first line 
of the file, searching for a format specification. If it 
finds one there, it sets the tab stops according to it, oth- 
erwise it sets them as -8. This type of specification may 
be used to make sure that a tabbed file is printed with 
correct tab settings. 


Any of the following may be used also; if a given flag occurs more 
than once, the last value given takes effect: 


-Ttype 

newform usually needs to know the type of terminal in 
order to set tabs and always needs to know the type to 
set margins. type is a name listed in term(CT). If no -T 
flag is supplied, newform searches for the $TERM value 
in the environment (see environ(M)). If no type can be 
found, newform tries a sequence that will work for many 
terminals. 


+mn The margin argument may be used for some terminals. It 
causes all tabs to be moved over n columns by making 
column n+1 the left margin. If +m is given without a 
value of n, the value assumed is 10. For a TermiNet, the 
first value in the tab list should be 1, or the margin will 
move even further to the right. The normal (leftmost) 
margin on most terminals is obtained by +m0. The mar- 
gin for most terminals is reset only when the +m flag is 
given explicitly. | 


Example 


In the following example, newform converts a file named text with 
leading digits, one or more tabs, and text on each line to a file 
beginning with the text and the leading digits placed at the end of 
each line in column 73 (-s option). All tabs after the first one are 
expanded to spaces (-i option). To reach the line length of 72 char- 
acters (-l option), spaces are appended to each line up to column 
72 (-a option) or lines are truncated at column 72 (-e option). To 
reformat the sample file text in this manner, enter: 
newform -s -i -l -a -e text 
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Exit Codes 
0 - normal execution 
1 - for any error 

See Also 


csplit(C) 


Diagnostics 
All diagnostics are fatal. 
SEL. aaa 
not -s format 
can’t open file 
internal line too long 


tabspec in error 


tabspec indirection illegal 


Notes 


NEWFORM (C) 


Newform was called with a bad option. 
There was no tab on one line. 
Self-explanatory. 

A line exceeds 512 characters after being 
expanded in the internal work buffer. 

A tab specification is incorrectly format- 
ted, or specified tab stops are not ascend- 
ing. 

A tabspec read from a file (or standard 
input) may not contain a _  tabspec 
referencing another file (or standard 
input). 


Newform normally only keeps track of physical characters; how- 
ever, for the -i and -o options, newform will keep track of back- 
spaces in order to line up tabs in the appropriate logical columns. 


Newform will not prompt the user if a tabspec is to be read from 
the standard input (by use of -i,-- or -o--). 


If the -f option is used, 


and the last -o option specified was and 


was preceded by either or a the tab specification format line will be 


incorrect. 
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Name 


newgrp — Logs user in to a new group. 


Syntax 


newgrp [ group | 


Description 
Newegrp changes the group identification of its caller. The same 
person remains logged in, and the current directory is unchanged, 
but calculations of access permissions to files are performed with 
respect to the new group ID. 
Newgrp without an argument changes the group identification to the 
group in the password file; in effect it changes the group identifica- 
tion back to the caller’s orginal group. 
A password is demanded if the group has a password and the user 
himself does not, or if the group has a password and the user is not 
listed in /etc/group as being a member of that group. 


When most users log in, they are members of the group named 
other. 

Files 
/etc/group 


/etc/passwd 


See Also 


login(M), group(M) 


Notes 
There is no convenient way to enter a password into /etc/group. 
Use of group passwords is not encouraged, because, by their very 
nature, they encourage poor security practices. Shell variables are 


not preserved when invoking this command unless they are expli- 
citly exported. 
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Name 


news — Print news items. 


Syntax 


news [| —a ][—n ][ —s | [ items ] 


Description 


News is used to keep the user informed of current events. By con- 
vention, these events are described by files in the directory 
/usr/news. 


When invoked without arguments, news prints the contents of all 
current files in /usr/news, most recent first, with each preceded by 
an appropriate header. News stores the “‘currency” time as the 
modification date of a file named .news_time in the user’s home 
directory (the identity of this directory is determined by the 
environment variable $HOME); only files more recent than this 
currency time are considered “‘current.” 


The -—a option causes news to print all items, regardless of 
currency. In this case, the stored time is not changed. 


The —n option causes news to report the names of the current 
items without printing their contents, and without changing the 
stored time. 


The —s option causes news to report how many current items exist, 
without printing their names or contents, and without changing the 
stored time. 


All other arguments are assumed to be specific news items that are 
to be printed. 


If the INTERRUPT key is struck during the printing of a news item, 


printing stops and the next item is started. Another INTERRUPT 
within one second of the first causes the program to terminate. 
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Files 


/usr/news/* 
$HOME/.news_time 


See Also 


profile(M), environ(M). 
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Name 


nice — Runs a command at a different priority. 


Syntax 


nice [ —increment | command [ arguments ] 


Description 


Nice executes command with a lower CPU scheduling priority. 
Priorities range from 0 to 39, where 0 is the highest priority and 39 
is the lowest. By default, commands have a priority of 20. If an 
—increment argument is given where increment is in the range 1-19, 
increment is added to the default priority of 20 to produce a numeri- 
cally higher priority, meaning a lower scheduling priority. If no 
increment is given, an increment of 10 to produce a priority of 30 is 
assumed. 


The super-user may run commands with priority higher than normal 
by using a double negative increment. For example, an argument 
of --10 would decrement the default to produce a priority of 10, 
which is a higher scheduling priority than the default of 20. 

See Also 


nohup(C), nice(S) 


Diagnostics 


Nice returns the exit status of the subject command. 


Notes 


An increment larger than 19 is equivalent to 19. 
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Name 


nl — Adds line numbers to a file. 


Syntax 


nl [—htype] [—btype] [—ftype] [—vstart#] [—iincr] [—p] [—Inum] 
[—ssep] [—wwidth] [—nformat] file 


Description 


NI reads lines from the named file, or the standard input if no file 
is named, and reproduces the lines on the standard output. Lines 
are numbered on the left in accordance with the command options 
in effect. 


NI views the text it reads in terms of logical pages. Line numbering 
is reset at the start of each logical page. A logical page consists of 
a header, a body, and a footer section. Empty sections are valid. 
Different line numbering options are independently available for 
header, body, and footer (e.g. no numbering of header and footer 
lines while numbering blank lines only in the body). 


The start of logical page sections is signaled by input lines contain- 
ing nothing but the following character(s): 


Page Section _—__Line Contents 


Header yV\ 
Body \\ 
Footer \: 


Unless signaled otherwise, nl assumes the text being read is in a sin- 
gle logical page body. 


Command options may appear in any order and may be intermin- 
gled with an optional filename. Only one file may be named. The 
options are: 


—btype Specifies which logical page body lines are to be num- 
bered. Recognized types and their meaning are: a, 
number all lines; t, number lines with printable text 
only; n, no line numbering; pstring, number only lines 
that contain the regular expression specified in String. 
Default type for logical page body is t (text lines num- 
bered). 
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—htype 


—ftype 


—p 


—vstart# 


—WNcr 


—ssep 


—wwidth 


—nformat 


—Inum 


See Also 
pr(C) 


NL (C) 


Same as —btype except for header. Default type for logi- 
cal page header is n (no lines numbered). 


Same as —btype except for footer. Default for logical 
page footer is n (no lines numbered). 


Does not restart numbering at logical page delimiters. 


Start# is the initial value used to number logical page 
lines. Default is 1. 


Incr is the increment value used to number logical page 
lines. Default is 1. 


Sep is the character(s) used in separating the line 
number and the corresponding text line. Default sep is a 
tab. 


Width is the number of characters to be used for the line 
number. Default width is 6. 


Format is the line numbering format. Recognized values 
are: In, left justified, leading zeroes supressed; rn, nght 
justified, leading zeroes supressed; rz, mght justified, 
leading zeroes kept. Default format is rn (right 
justified). 


Num is the number of blank lines to be considered as 
one. For example, —12 results in only the second adja- 
cent blank being numbered (if the appropriate —ha, 
—ba, and/or —fa option is set). Default is 1. 
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Name 


nohup — Runs a command immune to hangups and quits. 


Syntax 


nohup command [ arguments |] 


Description 
Nohup executes command with hangups and quits ignored. If out- 
put is not redirected by the user, it will be sent to nohup.out. If 
nohup.out does not have write permission in the current directory, 
output is redirected to $HOME/nohup. out. 

See Also 


nice(C), signal(S) 
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Name 


od — Displays files in octal format. 


Syntax 
od [—bcdox] [ file ] [ [ + Joffset[ . ][ b ] ] 


Description 

Od displays file in one or more formats as selected by the first argu- 

ment. If the first argument is missing, —o is default. The meanings 

of the format options are: 

—b Interprets bytes in octal. 

—c Interprets bytes in ASCII. Certain nongraphic characters 
appear as C escapes: null=\0, backspace=\b, form feed=Vf, 
newline=\n, return=\r, tab=\t; others appear as 3-digit octal 
numbers. 

-d Interprets words in decimal. 

-o Interprets words in octal. 


-x Interprets words in hex. 


The filé argument specifies which file is to be displayed. If no file 
argument is specified, the standard input is used. 


The offset argument specifies the offset in the file where displaying 
is to start. This argument is normally interpreted as octal bytes. If 

is appended, the offset is interpreted in decimal. If b is 
appended, the offset is interpreted in blocks. If the file argument is 
omitted, the offset argument must be preceded by +. 


The display continues until end-of-file. 


See Also 


hd(C), adb(CP) 
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Name 


pack, pcat, unpack — Compresses and expands files. 


Syntax 
pack [| — |] name... 
pcat name... 


unpack name... 


Description 


Pack attempts to store the specified files in a compressed form. 
Wherever possible, each input file name is replaced by a packed 
file name.z with the same access modes, access and modified dates, 
and the owner of name. If pack is successful, name will be 
removed. Packed files can be restored to their original form using 
unpack or pcat. 


Pack uses Huffman (minimum redundancy) codes on a byte-by-byte 
basis. If the — argument is used, an internal flag is set that causes 
the number of times each byte is used, its relative frequency, and 
the code for the byte to be printed on the standard output. Addi- 
tional occurrences of — in place of name wiil cause the internal flag 
to be set and reset. 


The amount of compression obtained depends on the size of the 
input file and the character frequency distribution. Because a 
decoding tree forms the first part of each .z file, it is usually not 
worthwhile to pack files smaller than three blocks, unless the char- 
acter frequency distribution is very scattered, which may occur with 
printer plots or pictures. 


Typically, text files are reduced to 60-75% of their original size. 
Load modules, which use a larger character set and have a more 
uniform distribution of characters, show little compression, the 
packed versions being about 90% of the original size. 


Pack returns a value that is the number of files that it failed to 
compress. 


No packing will occur if: 
— The file appears to be already packed 


— The filename has more than 12 characters 
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— The file has links 
— The file is a directory 
— The file cannot be opened 
— No disk storage blocks will be saved by packing 
— A file called name.z already exists 
— The .z file cannot be created 
— An I/O error occurred during processing 
The last segment of the filename must contain no more than 12 
characters to allow space for the appended .z extension. Direc- 
tories cannot be compressed. 
Pcat does for packed files what cat(C) does for ordinary files. The 
specified files are unpacked and written to the standard output. 
Thus to view a packed file named name.z use: 
peat name.z 
or just: 


pcat name 


To make an unpacked copy, say nnn, of a packed file named 
name.z without.destroying name.z, enter the command: 


peat name >nnn 


Pcat returns the number of files it was unable to unpack. Failure 
may occur if: 


— The filename (exclusive of the .z) has more than 12 characters 

— The file cannot be opened 

— The file does not appear to be the output of pack 

Unpack expands files created by pack. For each file name specified 
in the command, a search is made for a file called name.z (or just 
name, if name ends in .z). If this file appears to be a packed file, 
it is replaced by its expanded version. The new file has the .z suffix 


stripped from its name, and has the same access modes, access and 
modification dates, and owner as those of the packed file. 
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Unpack returns a value that is the number of files it was unable to 


unpack. Failure may occur for the same reasons that it may in 
peat, as well as in a file where the “unpacked” name already exists, 


or if the unpacked file cannot be created. 
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Name 


passwd — Changes login password. 


Syntax 


passwd name 


Description 


This command changes (or installs) a password associated with the 
login name. 


The program prompts for the old password (if any) and then for 
the new one (twice). The user must supply these. Passwords can 
be of any reasonable length, but only the first eight characters of 
the password are significant. —The minimum number of characters 
allowed in a new password is determined by the PASSLENGTH 
variable. Although the minimum can be 3, a minimum of 5 charac- 
ters is strongly recommended since passwords shorter than this are 
much easier to guess or discover by trial and error. 


Only the owner of the name or the super-user may change a pass- 
word; the owner must prove he knows the old password. Only the 
super-user can create a null password. 


The password file is not changed if the new password is the same as 
the old password, or if the password has not “aged” sufficiently; 
see passwd (M)). 


The minimum length of a legal password, and the minimum and 
maximum number of weeks used in password aging are specified in 
/etc/default/passwd by the variables PASSLENGTH, MINWEEKS 
and MAXWEEKS. If not explicitly set, the default values for these 
variables are: 


PASSLENGTH=5 
MINWEEKS=2 
MAXWEEKS=4 


MINWEEKS and MAXWEEKS values must be in the range 0 to 63. 
If PASSLENGTH is not in the range 3 to 8, it is set to 5. 


Files 


/etc/default/passwd 
/etc/passwd 


See Also 
default(M), login(M), passwd(M), pwadmin(C) 
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Name 


pg - File perusal filter for soft-copy terminals. 


Syntax 


pg [- number ] [-p string | [-cefns] [+ linenumber | [+/ pattern /] 
EtHeS: <<. 


Description 


The pg command is a filter which allows the examination of files 
one screenful at a time on a soft-copy terminal. (The dash (-) 
command line option and/or NULL arguments indicate that pg 
should read from the standard input.) Each screenful is followed by 
a prompt. If you press the RETURN key, another page is 
displayed; other possibilities are listed below. This command is 
different from previous paginators because it allows you to back up 
and review something that has already passed. 


To determine terminal attributes, pg scans the termcap(M) data 
base for the terminal type specified by the environment variable 
TERM. If TERM is not defined, the terminal type dumb is 
assumed. 


The command line options are: 


-number Specifies the size (in lines) of the window that pg is to 
use instead of the default. (On a terminal containing 
24 lines, the default window size is 23.) 


-p string Causes pg to use string as the prompt. If the prompt 
string contains a ““%d”’, the first occurrence of “%d” 
in the prompt will be replaced by the current page 
number when the prompt is issued. The default 
prompt string is a colon (:). 


-C Homes the cursor and clears the screen before 
displaying each page. This option is ignored if 
clear_screen is not defined for this terminal type in the 
termcap(M) data base. 


-e Causes pg not to pause at the end of each file. 


-f Inhibits pg from splitting lines. In the absence of the 
-f option, pg splits lines longer than the screen width, 
but some sequences of characters in the displayed text 
(for example, escape sequences for underlining) give 
undesirable results. 
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-n Normally, commands must be terminated by pressing 
the RETURN key (ASCII newline character). This 
option causes an automatic end of command as soon 
as a command letter is entered. 


-S Causes pg to display all messages and prompts in 
standout mode (usually inverse video). 


+linenumber 
Starts up at linenumber. 


+/pattern/ Starts up at the first line containing the regular 
expression pattern. 


The responses that may be entered when pg pauses can be divided 
into three categories: those that cause further perusal, those that 
search, and those that modify the perusal environment. 


Commands which cause further perusal normally take a preceding 
address (an optionally signed number indicating the point from 
which further text should be displayed). Pg interprets this address 
in either pages or lines depending on the command. A signed 
address specifies a point relative to the current page or line, and an 
unsigned address specifies an address relative to the beginning of 
the file. Each command has a default address if no address is 
provided. 


The perusal commands and their defaults are as follows: 


(+1)RETURN key or <blank> 
Causes one page to be displayed. The address is specified in 


pages. 


(+1) 1 
With a signed address, causes pg to simulate scrolling the 
screen, forward or backward, the number of lines specified. 
With an unsigned address this command displays a full screen of 
text beginning at the specified line. 


(+1) d or Ctrl-D 
Simulates scrolling half a screen forward or backward. 


The following perusal commands take no address: 


. or Ctri-L 
Causes the current page of text to be redisplayed. 


$ Displays the last window full in the file. Use with caution when 
the input is a pipe. 
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The following commands are available for searching for text 
patterns in the text. The regular expressions described in ed(C) are 
available. They must always be terminated by a newline character, 
even if the -” option is specified. 


i/pattern/ 
Search forward for the ith (default i=1) occurrence of pattern. 
Searching begins immediately after the current page and 
continues to the end of the current file, without wrap-around. 


i“pattern™ 

i2pattern? 
Search backwards for the ith (default i=1) occurrence of 
pattern. Searching begins immediately before the current page 
and continues to the beginning of the current file, without 
wrap-around. The caret (“) notation is useful for terminals 
which will not properly handle the question mark (?). 


After searching, pg displays the line found at the top of the screen. 
You can modify this by appending m or b to the search command 
to leave the line found in the middle or at the bottom of the 
window from now on. Use the suffix t to restore the original 
situation. 


You can modify the environment of perusal with the following 
commands: 


in Begins perusing the ith next file in the command line. Thei 
is an unsigned number, default value is 1. 


ip Begins perusing the ith previous file in the command line. 
The i is an unsigned number, default is 1. 


iw Displays another window of text. If i is present, set the 
window size to 1. 


s filename 
Saves the input in the named file. Only the current file 
being perused is saved. The white space between the s and 
filename is optional. This command must always be 
terminated by a newline character, even if the -n option is 
specified. 


h Help by displaying an abbreviated summary of available 
commands. 


q or Q Quit pg. 


!command 
Command is passed to the shell, whose name is taken from 
the SHELL environment variable. If this is not available, 
the default shell is used. This command must always be 
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terminated by a newline character, even if the -n option is 
specified. 


At any time when output is being sent to the terminal, the user can 
press the quit key (normally Ctrl-\) or the INTERRUPT (BREAK) 
key. This causes pg to stop sending output, and display the 
prompt. The user may then enter one of the above commands in 
the normal manner. Unfortunately, some output is lost when this is 
done, because any characters waiting in the terminal’s output queue 
are flushed when the quit signal occurs. 

If the standard output is not a terminal, then pg acts just like 
cat(C), except that a header is printed before each file (if there is 
more than one). 

Example 


To use pg to read system news, enter: 


news | pg -p “(Page %d):” 


Files 
/etc/termcap Terminal information data base 


/tmp/pg* Temporary file when input is from a pipe 


See Also 


ed(C), grep(C), termcap(M) 


Notes 


If terminal tabs are not set every eight positions, undesirable results 
may Occur. 


When using pg as a filter with another command that changes the 
terminal I/O options terminal settings may not be restored correctly. 


While waiting for terminal input, pg responds to "BREAK, DEL," 
and the caret (°) by terminating execution. Between prompts, 
however, these signals interrupt pg’s current task and place you in 
prompt mode. Use these signals with caution when input is being 
read from a pipe, since an interrupt is likely to terminate the other 
commands in the pipeline. 
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The z and f commands used with more are available, and the 
terminal slash (/), caret (°), or question mark (?) may be omitted 
from the searching commands. 
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Name 


pr — Prints files on the standard output. 


Syntax 


pr [ options ] [ files ] 


Description 


Pr prints the named files on the standard output. If file is —, or if 
no files are Specified, the standard input is assumed. By default, 
the listing is separated into pages, each headed by the page 
number, date and time, and the name of the file. 


By default, columns are of equal width, separated by at least one 
space; lines which do not fit are truncated. If the —s option is 
used, lines are not truncated and columns are separated by the 
separation character. 


If the standard output is associated with a terminal, error messages 
are withheld until pr has completed printing. 


Options may appear singly or combined in any order. Their mean- 
ings are: 


+k Begins printing with page k (default is 1). 


=k Produces k-column output (default is 1). The options —e 
and —i are assumed for multicolumn output. 


—a Prints multicolumn output across the page. 


—m Merges and prints all files simultaneously, one per column 
(overrides the —k, and —a options). 


—d Double-spaces the output. 


—eck Expands input tabs to character positions k+1, 2*k+1, 
3*k+1, ete. If k is O or is omitted, default tab settings at 
every 8th position are assumed. Tab characters in the input 
are expanded into the appropriate number of spaces. If c 
(any nondigit character) is given, it is treated as the input 
tab character (default for c is the tab character). 


—ick In output, replaces whitespace wherever possible by insert- 
ing tabs to character positions k+1, 2*k+1, 3*k+1, etc. Ifk 
is O or is omitted, default tab settings at every 8th position 
are assumed. If c (any nondigit character) is given, it is 
treated as the output tab character (default for c is the tab 
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—nck 


™SC 


Examples 


PR (C) 


character). 


Provides k-digit line numbering (default for k is 5). The 
number occupies the first k+1 character positions of each 
column of normal output or each line of —m output. If c 
(any nondigit character) is given, it is appended to the line 
number to separate it from whatever follows (default for c is 
a tab). 


Sets the width of a line to k character positions (default is 
72 for equal-width multicolumn output, no limit otherwise). 


Offsets each line by k character positions (default is 0). The 
number of character positions per line is the sum of the 
width and offset. 


Sets the length of a page to k lines (default is 66). 


Uses the next argument as the header to be printed instead 
of the filename. 


Pauses before beginning each page if the output is directed 
to a terminal (pr will ring the bell at the terminal and wait 
for a carriage return). 


Uses form feed character for new pages (default is to use a 
sequence of linefeeds). Pauses before beginning the first 
page if the standard output is associated with a terminal. 


Prints no diagnostic reports on failure to open files. 


Prints neither the 5-line identifying header nor the 5-line 
trailer normally supplied for each page. Quits printing after 
the last line of each file without spacing to the end of the 


page. 


Separates columns by the single character c instead of by 
the appropriate number of spaces (default for c is a tab). 


The following prints file] and file2 as a double-spaced, three-column 
listing headed by “‘file list”’: 


pr —3dh "file list” filel file2 
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The following writes filel on file2, expanding tabs to columns 10, 


| Ue a FS 
pr —e9 -t <filel >iileZ 
See Also 


cat(C) 
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Name 


PS (C) 


ps — Reports process status. 


Syntax 


ps [ options ] 


Description 


Ps prints certain information about active processes. Without 
options, information is printed about processes associated with the 
current terminal. Otherwise, the information that is displayed is 
controlled by the following options: 


=¢ 


= 


“=a 


—| 
—c corefile 


—s swapdev 


—n namelist 


—t tlist 
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Prints information about all processes. 


Prints information about all processes, except process 
group leaders. 


Prints information about all processes, except process 
group leaders and processes not associated with a ter- 
minal. 


Generates a full listing. (Normally, a short listing con- 
taining only process ID, terminal (“‘tty’’) identifier, 
cumulative execution time, and the command name is 
printed.) See below for meaning of columns in a full 
listing. 


Generates a long listing. See below. 
Uses the file corefile in place of /dev/mem. 


Uses the file swapdev in place of /dev/swap. This is 
useful when examining a corefile. 


The argument is taken as the name of an alternate 
namelist (/xenix is the default). 


Restricts listing to data about the processes associated 
with the terminals given in ¢list, where ¢list can be in 
one of two forms: a list of terminal identifiers 
separated from one another by a comma, or a list of 
terminal identifiers enclosed in double quotes and 
separated from one another by a comma and/or one 
or more spaces. 
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—p plist 


—u ulist 


—g glist 


The column 


PS (C) 


Restricts listing to data about processes whose process 
ID numbers are given in plist, where plist is in the 
same format as Tlist. 


Restricts listing to data about processes whose user ID 
numbers or login names are given in ulist, where ulist 
is in the same format as Zlist. In the listing, the 
numerical user ID is printed unless the —f option is 
used, in which case the login name is printed. 


Restricts listing to data about processes whose process 
groups are given in glist, where glist is a list of process 
group leaders and is in the same format as Zlist. 


headings and the meaning of the columns in a ps list- 


ing are given below; the letters f and | indicate the option (full or 
long) that causes the corresponding heading to appear; all means 
that the heading always appears. Note that these two options only 
determine what information is provided for a process; they do not 
determine which processes will be listed. 


F (1) 
S (1) 
UID (f,1) 
PID (all) 
PPID (f,1) 
C (f,1) 
STIME (f) 
PRI (1) 
NI (1) 
ADDR (I) 
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A status word consisting of flags associated with 
the process. Each flag is associated with a bit in 
the status word. These flags are added to form a 
single octal number. Process flag bits and their 
meanings are: 
01 in core; 
02 system process; 
04 locked in core (e.g., for physical I/O); 
10 being swapped; 
20 being traced by another process. 
The state of the process: 
non-existent; 
sleeping; 
waiting; 
running; 
intermediate; 
terminated; 
stopped. 
The user ID number of the process owner; the 
- login name is printed under the —f option. 
The process ID of the process; it is possible to kill 
a process if you know this datum. 
The process ID of the parent process. 
Processor utilization for scheduling. 
Starting time of the process. 
The priority of the process; higher numbers mean 
lower priority. 
Nice value; used in priority computation. 
The memory address of the process, if resident; 
otherwise, the disk address. 


HN“WEHO 
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SZ (1) ~~ The size in blocks of the core image of the pro- 
cess, but not including the size of text shared with 
other processes. Since this size includes the 
current size of the stack, it will vary as the stack 
size varies. 

WCHAN (1) The event for which the process is waiting or 
sleeping; if blank, the process is running. 

TTY (all) The controlling terminal for the process. 

TIME = (all) The cumulative execution time for the process. 

CMD (all) The command name; the full command name and 
its arguments are printed under the —f option. 


A process that has exited and has a parent, but has not yet been 
waited for by the parent, is marked <defunct>. 


Under the —f option, ps tries to determine the command name and 

arguments given when the process was created by examining 

memory or the swap area. Failing this, the command name, as it 

would appear without the —f option, is printed in square brackets. 
Files 

/xenix system namelist 


/dev/mem memory 


/dev searched to find swap device and terminal (‘‘tty”’) names. 


See Also 


kill(C), nice(C) 


Notes 


Things can change while ps is running; the picture it gives is only a 
close approximation to reality. 


Some data printed for defunct processes are irrelevant. 
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Name 


pstat — Reports system information. 


Syntax 


pstat [ —aixptf ] [ —u ubase | [ —c corefile | 
[ —n namelist | [ file ] 


Description 


Pstat interprets the contents of certain system tables. Pstat searches 
for these tables in /dev/mem and /dev/kmem. With the file given, 
the tables are sought in the specified file rather than /dev/mem. 
Similarly, the —¢ option allows one to specify a corefile rather than 
/dev/kmem for the search. The required namelist is taken from 
/xenix. Options are: 


—a Under —p, describe all process slots rather than just 
active ones. 7 


—i Print the inode table with these headings: 
LOC The core location of this table entry. 
FLAGS Miscellaneous state variables encoded thus: 
L Locked 
U_ Update time filesystem(F) must be corrected 
A Access time must be corrected 
M File system is mounted here 
W Wanted by another process (L flag is on) 
T Contains a text file 
C Changed time must be corrected 
CNT Number of open file table entries for this inode. 
DEV Major and minor device number of file system in 
which this inode resides. 
INO I-number within the device. 
MODE Mode bits, see chmod (S). 
NLK Number of links to this inode. 
UID User ID of owner. 
SIZ/DEV 
Number of bytes in an ordinary file, or major 
and minor device of special file. 


—xX Prints the text table with these headings: 
LOC Thecore location of this table entry. 
FLAGS Miscellaneous state variables encoded thus: 
T ptrace(S) in effect 
W Text not yet written on swap device 
L Loading in progress 
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K Locked 
w Wanted (L flag is on) 

DADDR 
Disk address in swap, measured in multiples of 
BSIZE bytes. 

CADDR 
Core address, measured in units of memory 
management resolution. 

SIZE Size of text segment, measured in units of 
memory management resolution. 

IPTR Core location of corresponding inode. 

CNT Number of processes using this text segment. 

CCNT Number of processes in core using this text seg- 
ment. 


Prints process table for active processes with these head- 
ings: 
LOC Thecore location of this table entry. 
S Run state encoded thus: 
No process 
Waiting for some event 
Runnable 
Being created 
Being terminated 
Stopped under trace 
F Miscellaneous state variables, ORed together: 
01 Loaded 
02 The scheduler process 
04 Locked 
010 
Swapped out 
020 
Traced 


NWN R We © 


Used in tracing 
0100 
Locked in by lock(S). 
PRI Scheduling priority, see nice (S). 
SIGNAL 
Signals received (signals 1-16 coded in bits 0- 
15). 
UID Real user ID. 
TIM Time resident in seconds; times over 127 coded 


as 127. 
CPU _— Weighted integral of CPU time, for scheduler. 
NI Nice level, see nice(S). 


PGRP Process number of root of process group (the 
opener of the controlling terminal). 

PID The process ID number. 

PPID _ The process ID of parent process. 
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ADDR If in core, the physical address of the “u-—area” 


of the process measured in units of memory 
management resolution. If swapped out, the 
position in the swap area is measured in multi-— 
ples of BSIZE bytes. 


SIZE Size of process image, measured in units of 
memory management resolution. 
WCHAN 


Wait channel number of a waiting process. 


LINK Link pointer in list of runnable processes. 
TEXTP If text is pure, pointer to location of text table 


entry. 


CLKT Countdown for alarm(S) measured in seconds. 


—u ubase 


Print information about a user process. Ubase is the hex- 
adecimal location of the process in main memory. The 
address may be obtained by using the long listing ( —1 
option) of the ps(C) command. 


—c corefile 


Use the file corefile in place of /dev/kmem. 


—n namelist 


Use the file namelist as an alternate namelist in place of 


/xenix. 
~f Print the open file table with these headings: 
LOC _ The core location of this table entry. 
_FLG Miscellaneous state variables: 
R Open for reading 
W Open for wniting 
P Pipe 
CNT Number of processes that know this open file. 
INO The location of the inode table entry for this 
file. 
OFFS The file offset, see lseek(S). 
Files 
/xenix Namelist 


/dev/mem Default source of tables 


See Also 


ps(C), stat(S), filesystem(F) 
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Name 

pwadmin — Performs password aging administration. 
Syntax 

pwadmin [ —min weeks —max weeks | options 
Description 


Pwadmin is used to examine and modify the password aging infor- 
mation in the password file. The options one can specify are as fol- 
lows: 


—d user 
Displays the password aging information. 


—f user 
Forces the user to change his password at the next login. 


—c user 
Prevents the user from changing his password. 


—a user 

Enables password aging for the given user. This option sets 
the minimum number of weeks that the user must wait 
before changing his password and the maximum number of 
weeks that a user can keep his current password for the 
values defined by the MINWEEKS and MAXWEEKS vari- 
ables in the /etc/default/passwd file. If the file is not 
found or the defined values are not in the range 0 to 63, the 
default values 2 and 4 are used. 


—n user 
Disables the password aging feature. 


—min weeks 
Enables password aging and sets the minimum number of 
weeks before the user can change his password to weeks. 
(This prevents him from changing his password back to the 
old one). 


—max weeks 
Enables password aging and sets the number of weeks so 
the user can keep his current password set for weeks. 
Files 
/etc/passwd 
See Also 


passwd(C), passwd(M) 
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Notes 


The user must not attempt to force a new password by setting both 
the —min and —max values to zero. To force a password, use the 
—f option. 


The user must not attempt to prevent further password changes by 
setting the —min value greater than the —max value. To prevent 
changes, use the —c option. 
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Name 


pwcheck — Checks password file. 


Syntax 


pweheck [file | 


Description 
Pwcheck scans the password file and checks for any inconsisten- 
cies. The checks include validation of the number of fields, login 
name, user ID, group ID, and whether the login directory and 
optional program name exist. The default password file is 
/etc/passwd. 

Files 


/etc/passwd 


See Also 


grpcheck(C), group(M), passwd(M) 
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Name 


pwd — Prints working directory name. 


Syntax 


pwd 


Description 


Pwd prints the pathname of the working (current) directory. 


See Also 
cd(C) 


Diagnostics 


bP >) 


“Cannot open ..” and “Read error in ..”’ indicate possible file sys- 
tem trouble. In such cases, see the XENIX Operations Guide for 
information on fixing the file system. 
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Name 


quot — Summarizes file system ownership. 


Syntax 


quot [ option }]... [ filesystem ] 


Description 
Quot prints the number of blocks in the named filesystem currently 
owned by each user. If no filesystem is named, the file systems 
given in /etc/mnttab are examined. 


The following options are available: 


-n Causes the following pipeline to produce a list of all files and 
their owners: 


ncheck filesystem | sort +On | quot -n filesystem 
-c Prints three columns giving file size in blocks, number of files of 
that size, and cumulative total of blocks in that size or smaller 
file. Data for files of size greater than 499 blocks are included 
in the figures for files of exactly size 499. 


-f Prints a count of the number of files as well as space owned by 


each. user. 
Files 
/etc/passwd Gets user names 
/etc/mnttab Contains list of mounted file systems 
See Also 


cmchk(C), du(C), Is(C), machine(M) 
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Notes 
Holes in files are counted as if they actually occupied space. 
Blocks are reported in 512 byte blocks. On filesystems that use 
1024 byte blocks, a file of 26 bytes is reported as using 2 blocks, 
since it uses one 1024 byte block, or two 512 byte blocks. See 
machine(M) or use cmchk(C) to determine the filesystem block 
SIZe. 


See also Notes under mount(C). 
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Name 


random — Generates a random number. 


Syntax 


random [—s]| scale | 


Description 
Random generates a random number on the standard output. and 
returns the number as its exit value. By default, this number is 
either 0 or 1 (i.e., scale is 1 by default). If scale is given a value 
between 1 and 255, then the range of the random value is from 0 to 
scale. If scale is greater than 255, an error message is printed. 
When the <—s , “silent” option is given, the random number is 


returned as an exit value but is not printed on the standard output. 
If an error occurs, random returns an exit value of zero. 


See Also 


rand(S) 


Notes 
This command does not perform any floating point computations. 


Random uses the time of day as a seed. 
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Name 


rcp — Copies files across XENIX systems. 


Syntax 


rep [ options | [srcmachine:]srcfile [destmachine: |destfile 


Description 


Rcp copies files between systems in a Micnet network. The com- 
mand copies the srcmachine:srcfile to destmachine:destfile, where 
srcmachine: and destmachine: are optional names of systems in the 
network, and srcfile and destfile are pathnames of files. If a 
machine name is not given, the name of the current system is 
assumed. If — is given in place of srcfile, rcp uses the standard 
input as the source. Directories named on the destination machine 
must have write permission, and directories and files named on a 
remote source machine must have read permission. 


The available options are: 


—m 
Mails and reports completion of the command, whether there is 
an error or not. 


—u_ [machine: |user . 
Any mail goes to the named user on machine. The default 
machine is the machine on which the rcp command is completed 
or on which an error was detected. If an alias for user exists in 
the system alias files on that machine, the mail will be redirected 
to the appropriate mailbox(es). Since system alias files are usu- 
ally identical throughout the network, any specified machine will 
most likely be overridden by the aliasing mechanism. To 
prevent aliasing, user must be escaped with at least two \charac- 
ters (at least four if given as a shell command). 
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Rcp is useful for transferring small numbers of files across the net- 
work. The network consists of daemons that periodically awaken 
and send files from one system to another. The network must be 
installed using netutil(C) before rcp can be used. Also, to enable 
transfer of files from a remote system, the line 

rcp=/usr/bin/rcp 
/etc/default/micnet on the systems in the network, or: 


1) “‘executeall” must be present AND 
2) the “execpath=PATH=...” must include /usr/bin 


Example 


rcp —m machinel:/etc/mnttab /tmp/vtape 


See Also 


mail(C), micnet(M), netutil(C), remote(C) 


Diagnostics 


If an error occurs, mail is sent to the user. 


Notes 
Full pathnames must be specified for remote files. 
Rcp handles binary data files transparently, no extra options or pro- 


tocols are needed to handle them. Wildcards are not expanded on 
the remote machine. 
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Name 


red — Invokes a restricted version of ed(C). 


Syntax 


red | file | 


Description 
Red is a restricted version of ed(C). It will only allow editing of 
files in the current directory. It prohibits executing sh(C) com- 
mands via the ! command. Red displays an error message on any 
attempt to bypass these restrictions. 
In general, red does not allow commands like 

date 

or 


!sh 


Furthermore, red will not allow pathnames in its command line. 
For example, the command: 


red /etc/passwd 


when the current directory is not /etc causes an error. 


See Also 


ed(C), rsh(C) 
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Name 


remote — Executes commands on a remote XENIX system. 


Syntax 


remote [| — | [ —-f file | [ —m ] [ —u user] machine 
command [ arguments | 


Description 


Remote is a limited networking facility that permits execution of 
XENIX commands across serial lines. Commands on any con- 
nected system may be executed from the host system using remote. 
A command line consisting of command and any blank-separated 
arguments is executed on the remote machine. A machine’s name 
is located in the file /etc/systemid. Note that wild cards are not 
expanded on the remote machine, so they should not be specified 
in arguments. ID. The optional —m switch causes mail to be sent 
to the user telling whether the command is successful. 


The available options follow: 


= A dash signifies that standard input is used as the stan- 
dard input for command on the remote machine. Stan- 
dard input comes from the local host and not from the 
remote machine. 


—f file Use the specified file as the standard input for command 
on the remote machine. The file exists on the local host 
and not on the remote machine. 


—m Mails the user to report completion of the command. 
By default, mail reports only errors. 


—u user Any mail goes to the named user on machine. The 
default machine is the machine on which an error was 
detected, or on which the remote command was com- 
pleted. The mail will be redirected to the appropriate 
mailbox(es), if an alias for user exists in the system alias 
files on that machine . Since system alias files are usually 
identical throughout the network, any specified machine 
will most likely be overridden by the aliasing mechanism. 
To prevent aliasing, user must be escaped with at least 
two \ characters (at least four if given as a shell com- 
mand). 
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Before remote can be successfully used, a network of systems must 
first be set up and the proper daemons initialized using netutil (C). 
Also, entries for the command to be executed using remote must be 
added to the /etc/default/micnet files on each remote machine. 


Example 


The following command executes an /s command on the directory 
/tmp of the machine machinel: 


remote machinel Is /tmp 


See Also 


rcp(C), mail(C), netutil(C), micnet(M) 


Notes 


The mail command uses the equivalent of remote to send mail 
between machines. 
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Name 


restore, restor — Invokes incremental file system restorer. 


Syntax 
restore key [ arguments | 


restor key | arguments | 


Description 


restore is used to read archive media backed up with the backup(C) 
command. The key specifies what is to be done. Key is one of the 
characters rRxt, optionally combined with f. restor is an alternate 
spelling for the same command. 


f Uses the first argument as the name of the archive (backup dev- 
ice /dev/*) instead of the default. 


r,R 
The archive is read and loaded into the file system specified in 
argument. ‘This should not be done lightly (see below). If the 
key is R, restore asks which archive of a multivolume set to start 
on. This allows restore to be interrupted and then restarted (an 
fsck must be done before the restart). 


x Each file on the archive named by an argument is extracted. 
The filename has all “mount” prefixes removed; for example, if 
/usr is a mounted file system, /usr/bin/Ipr is named /bin/Ipr on 
the archive. The extracted file is placed in a file with a numeric 
name supplied by restore (actually the inode number). In order 
to keep the amount of archive read to a minimum, the following 
procedure is recommended: 


1. Mount volume 1 of the set of backup archives. 


2. Type the restore command with the appropriate key and 
arguments. 


3. restore will check dumpdir, then announce whether or not it 
found the files, give the numeric name that it will assign to 
the file, and in the case of a tape, rewind to the start of the 
archive. 


4. It then asks you to “mount the desired tape volume’’. Type 
the number of the volume you choose. On a multivolume 
backup, the recommended procedure is to mount the last 
through the first volumes, in that order. restore checks to 
see if any of the requested files are on the mounted archive 
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(or a later archive, thus the reverse order). If the requested 
files are not there, restore doesn’t read through the tape. If 
you are working with a single-volume backup or if the 
number of files being restored is large, respond to the query 
with 1 and restore will read the archives in sequential order. 


t Prints the date the archive was written and the date the file sys- 
tem was backed up. 


The r option should only be used to restore a complete backup 
archive onto a clear file system, or to restore an incremental 
backup archive onto a file system so created. Thus: 


/etc/mkfs /dev/hd1 10000 
restore r /dev/hdl 


is a typical sequence to restore a complete backup. Another 
restore can be done to get an incremental backup in on top of this. 


A backup followed by a mkfs and a restore is used to change the 
size of a file system. 


Files 
rst* Temporary files 
/etc/default/backup Name of default archive device 


The default archive unit varies with installation. 


Notes 
It is not possible to successfully restore an entire active root file sys- 
tem. 

Diagnostics 
There are various diagnostics involved with reading the archive and 
writing the disk. There are also diagnostics if the i-list or the free 
list of the file system is not large enough to hold the dump. 
If the dump extends over more than one disk or tape, it may ask 
you to change disks or tapes. Reply with a newline when the next 
unit has been mounted. 


See Also 
-backup(C), dumpdir(C), fsck(C), mkfs(C) 
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Name 


rm, rmdir — Removes files or directories. 


Syntax 
rm [ —fri | file ... 
rmdir dir ... 

Description 
Rm removes the entries for one or more files from a directory. If 
an entry was the last link to the file, the file is destroyed. Removal 
of a file requires write permission in its directory, but neither read 
nor write permission on the file itself. 
If a file has no wnite permission and the standard input is a termi- 
nal, its permissions are printed and a line is read from the standard 
input. If that line begins with y, the file is deleted, otherwise the 
file remains. No questions are asked when the —f option is given 
or if the standard input is not a terminal. 
If a designated file is a directory, an error comment is printed 
unless the optional argument —r has been used. In that case, rm 
recursively deletes the entire contents of the specified directory, 
and the directory itself. 
If the —i (interactive) option is in effect, rm asks whether to delete 
each file, and if the —r option is in effect, whether to examine each 
directory. 


Rmdir removes empty directories. 


See Also 


rmdir(C) 


Diagnostics 


Generally self-explanatory. It is forbidden to remove the file .. to 
avoid the consequences of inadvertently doing something like: 


rm —-r .* 


It is also forbidden to remove the root directory of a given file sys- 
tem. 
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No more than 17 levels of subdirectories can be removed using the 
—r option. 
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Name 


rmdir — Removes directories. 


Syntax 
rmdir dir ... 

Description 
Rm removes the entries for one or more subdirectories from a 
directory. A directory must be empty before it can be removed. 
Rmdir enforces a standard and safe procedure for removing a direc- 
tory; the contents of the directory must be removed before the 
directory itself can be deleted with rmdir . Note that the “rm -r dir”’ 
command is a more dangerous alternative to rmdir. 
Rmdir removes entries for the named directories, which must be 
empty. 

See Also 


rm(C) 
Notes 


Rmdir will refuse to remove the root directory of a mounted file 
system. 
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Name 


rmuser — Removes a user from the system. 


Syntax 


/etc/rmuser 


Description 

Rmuser removes users from the system. It begins by prompting for 
a user name; after receiving a valid user name as a response, it then 
deletes the named user’s entry in the password file, and removes 
the user’s mailbox file, the .profile file, and the entire home direc- 
tory. It will also remove the users group entry in /etc/group if the 
user was the only remaining member of that group, and the group 
ID was greater than 50. 

Before removing a user ID from the system, make sure its mailbox 
is empty and that all files belonging to that user ID have been saved 
or deleted as required. 


The rmuser program will refuse to remove a user ID or any of its 
files if one or more of the following checks fails: 


— The user name given is one of the “system” user names such as 
root, sys, sysinfo, cron, or uucp. All user IDs less than 200 are 
considered reserved for system use, and cannot be removed 
using rmuser. Likewise, all group IDs less than 50 are not 
removable using rmuser. 

— The user’s mailbox exists and is not empty. 

— The user’s home directory contains files other than .profile. 

Rmuser can only be executed by the super-user. 

Files 

/etc/passwd 

/usr/spool/mail/username 

$HOME 

See Also 


mkuser(C), backup(C) 
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Name 


rsh — Invokes a restricted shell (command interpreter). 


Syntax 


rsh [ flags | [ name [ arg] ... ] ] 


Description 


Rsh is a restricted version of the standard command interpreter 
sh(C). It is used to set up login names and execution environments 
whose capabilitics are more controlled than those of the standard 
shell. The actions of rsh are identical to those of sh, except that 
changing directory with cd, setting the value of $PATH, using com- 
mand names containing slashes, and redirecting output using > 
and >> are all disallowed. 


When invoked with the name —rsh, rsh reads the user’s .profile 
(from $HOME/.profile). It acts as the standard sh while doing this, 
except that an interrupt causes an immediate exit, instead of caus- 
ing a return to command level. The restrictions above are enforced 
after .profile is interpreted. 


When a command to be executed is found to be a shell procedure, 
rsh invokes sh to execute it. Thus, it is possible to provide to the 
end user shell procedures that have access to the full power of the 
standard shell, while restricting him to a limited menu of com- 
mands; this scheme assumes that the end user does not have write 
and execute permissions in the same directory. 


The net effect of these rules is that the writer of the .profile has 
complete control over user actions, by performing guaranteed setup 
actions, then leaving the user in an appropriate directory (probably 
not the login directory). 


Rsh is actually just a link to sh and any flags arguments are the 
same as for sh(C). 


The system administrator often sets up a directory of commands 
that can be safely invoked by rsh. 


See Also 
sh(C), profile(M) 
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Name 


runbig - Runs a command that may require more memory than 
normal. 


Syntax 


runbig command [ arguments | 


Description 


Runbig executes commands that may require more memory than is 
normally available to a user process. While runbig is executing the 
specified command, it ignored the restriction on the default of 
memory available to the user process. The command will run 
normally unless it is, or grows to be larger than the amount of 
memory available to a user process. It is then locked in core 
memory and not swapped until it either exits or shrinks to a size 
less than or equal to the size of a default user process. 


The removal of the process size restriction during execution of 
runbig will be preserved during an exec(S) system call, but not fora 
fork(S) system call. 

See Also 


exec(S), fork(S) 


Notes 
Running programs greater than the default process size, and 
therefore, possibly greater than the size of the disk swap area, may 
severely impact system performance. 


Runbig has no effect on systems whose memory size is much less 
than the size of the disk swap area. 
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Name 


sddate — Prints and sets backup dates. 


Syntax 


sddate [ name lev date |] 


Description 


If no argument is given, the contents of the backup date file 
‘“/etc/ddate” are printed. The backup date file is maintained by 
dump(C) and contains the date of the most recent backup for each 
backup level for each filesystem. 


If arguments are given, an entry :s replaced or made in 
‘“/etc/ddate”. name is the last component of the device pathname, 
lev is the backup level number (from 0 to 9), and date is a time in 
the form taken by date(C): 


mmddhhmm|yy] 
Where the first mm is a two-digit month in the range 01-12, dd is a 
two-digit day of the month, hh is a two-digit military hour from 00- 


23, and the final mm is a two-digit minute from 00-59. An optional 
two-digit year, yy, is presumed to be an offset from the year 1900, 


1.€:, 19yy. 
Some sites may wish to back up file systems by copying them verba- 
tim to backup media. Sddate could be used to make a “level 0” 
entry in “/etc/ddate”, which would then allow incremental backups. 
For example: 
sddate rhdO 5 10081520 

makes an “‘/etc/ddate” entry showing a level 5 backup of 
‘“/dev/rhdO” on October 8, at 3:20 PM. 

Files 


/etc/ddate 
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See Also 
dump(C), date(C) 


Diagnostics 


bad conversion If the date set is syntactically incorrect. 
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s Turns on silent mode; does not print ident- 
ical lines 


v Turns off silent mode 


e | 
Calls the editor with the left column 


er 
Calls the editor with the nght column 


e b 
Calls the editor with the concatenation of 
left and right 
e Calls the editor with a zero length file 
q Exits from the program 
On exit from the editor, the resulting file is con- 
catenated on the end of the output file. 


See Also 


diff(C), ed(C) 
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Name 


SDIFF (C) 


sdiff - Compares files side-by-side. 


Syntax 


sdiff [ options ... ] file1 file2 


Description 


Sdiff uses the output of diff(C) to produce a side-by-side listing of 
two files indicating those lines that are different. Each line of the 
two files is printed with a blank gutter between them if the lines are 
identical, a < in the gutter if the line only exists in filel, a > in the 
gutter if the line only exists in file2, and a | for lines that are dif- 


ferent. 


For example: 


X y 

a a 

b < 

2 < 

d d 
> Cc 


The following options exist: 


a 


—oO output 


Uses the next argument, n, as the width of the output 
line. The default line length is 130 characters. 


Only prints the left side of any lines that are identical. 
Does not print identical lines. 


Uses the next argument, output, as the name of a third 
file that is created as a user-controlled merging of file 
and file2. Identical lines of filel and file2 are copied to 
output. Sets of differences, as produced by diff(C), are 
printed; where a set of differences share a common 
gutter character. After printing each set of differences, 
sdiff prompts the user with a % and waits for one of 
the following user-typed commands: 


1 Appends the left column to the output file 


r Appends the nght column to the output file 
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Name 


sed — Invokes the stream editor. 


Syntax 


sed [ —n ][ —e script ] [ —f sfile ] [ files ] 


Description 


Sed copies the named files (standard input default) to the standard 
output, edited according to a script of commands. The —f option 
causes the script to be taken from file sfile; these options accumu- 
late. If there is just one —e option and no —f options, the flag —e 
may be omitted. The —n option suppresses the default output. A 
script consists of editing commands, one per line, of the following 
form: 


| address [ , address ] ] function [ arguments ] 


In normal operation, sed cyclically copies a line of input into a pat- 
tern space (unless there is something left after a D command), 
applies in sequence all commands whose addresses select that pat- 
tern space, and at the end of the script copies the pattern space to 
the standard output (except under —n) and deletes the pattern 
space. 


Some of the commands use a hold space to save all or part of the 
pattern space for subsequent retrieval. 


An address is either a decimal number that counts input lines 
cumulatively across files, a $ that addresses the last line of input, or 
a context address, 1.e., a /regular expression/ in the style of ed(C) 
modified as follows: 


- In a context address, the construction \?regular expression?, 
where ? is any character, is identical to /regular expression/. 
Note that in the context address \xabc\xdefx, the second x 
stands for itself, so that the regular expression is abexdef. 


- The escape sequence \n matches a newline embedded in the pat- 
tern space. 


- A period . matches any character except the terminal newline of 
the pattern space. 


—- A command line with no addresses selects every pattern space. 
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— A command line with one address selects each pattern space 
that matches the address. 


— A command line with two addresses selects the inclusive range 
from the first pattern space that matches the first address 
through the next pattern space that matches the second. (If the 
second address is a number less than or equal to the line 
number first selected, only one line is selected.) Thereafter, the 
process is repeated, looking again for the first address. 


Editing commands can be applied only to nonselected pattern 
spaces by use of the negation function ! (below). 


In the following list of functions, the maximum number of permissi- 
ble addresses for each function is indicated in parentheses. 


The text argument consists of one or more lines, all but the last of 
which end with backslashes to hide the newlines. Backslashes in 
text are treated like backslashes in the replacement string of an s 
command, and may be used to protect initial blanks and tabs 
against the stripping that is done on every script line. The rfile or 
wfile argument must terminate the command line and must be pre- 
ceded by exactly one blank. Each wifile is created before processing 
begins. There can be at most 10 distinct wfile arguments. 


(1) a\ 
text Appends text, placing it on the output before reading 
the next input line. 


(2) b label Branches to the : command bearing the label. If label is 
empty, branches to the end of the script. 


(2) €\ 

text Changes text by deleting the pattern space and then 
appending text. With O or 1 address or at the end of a 2- 
address range, places text on the output and starts the 
next cycle. 

(2)d Deletes the pattern space and starts the next cycle. 

(2)D Deletes the initial segment of the pattern space through 
the first newline and starts the next cycle. 

(2) g Replaces the contents of the pattern space with the con- 
tents of the hold space. 

(2)G Appends the contents of the hold space to the pattern 
space. 

(2)h Replaces the contents of the hold space with the con- 


tents of the pattern space. 
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(2)H 
(1) i\ 
text 
(2)1 
(2)n 
(2)N 
(2)p 
(2)P 
(1)q 


(2) r rfile 


SED (C) 


Appends the contents of the pattern space to the hold 
space. 


Insert. Places text on the standard output. 

Lists the pattern space on the standard output with non- 
printing characters spelled in two-digit ASCII and long 
lines folded. 


Copies the pattern space to the standard output. 
Replaces the pattern space with the next line of input. 


Appends the next line of input to the pattern space with 
an embedded newline. (The current line number 
changes. ) 


Prints (copies) the pattern space on the standard output. 


Prints (copies) the initial segment of the pattern space 
through the first newline to the standard output. 


Quits sed by branching to the end of the script. No new 
cycle is started. 


Reads the contents of rfile and places them on the out- 
put before reading the next input line. 


(2) s/regular expression/replacement/flags 


(2) t label 


Substitutes the replacement string for instances of the 


regular expression in the pattern space. Any character 


may be used instead of /. For a more detailed descrip- 
tion, see ed(C). Flags is zero or more of: 


g Globally substitutes for all nonoverlapping instances 
of the regular expression rather than just the first 
one. 


p Prints the pattern space if a replacement was made. 


w wfile 
Writes the pattern space to wifile if a replacement was 
made. 


Branches to the colon (:) command bearing label if any 
substitutions have been made since the most recent read- 
ing of an input line or execution of a t command. If 
label is empty, t branches to the end of the script. 


(2) w wfile Writes the pattern space to wiile. 
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(2)x Exchanges the contents of the pattern and hold spaces. 


(2) y/string1/string2/ 
Replaces all occurrences of characters in string] with the 
corresponding characters in string2. The lengths of 
string] and string2 must be equal. 


(2)! function 
Applies the function (or group, if function is {) only to 
lines not selected by the address(es). 


(0): label This command does nothing; it bears a label for b and t 
commands to branch to. 


(1) = Places the current line number on the standard output as 
a line. 
(2) { Executes the following commands through a matching } 
only when the pattern space is selected. 
(0) An empty command is ignored. 
See Also 


awk(C), ed(C), grep(C) 
The XENIX Text Processing Guide 


Notes 


This command is explained in detail in XENIX Text Processing 
Guide. 
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Name 


setcolor — set screen color 


Syntax 


setcolor — [nbrg] color [color] 


Description 


Setcolor allows the user to set the screen color on the color moni-— 
tor. Both foreground and background colors can be set indepen-— 
dently in a range of 16 colors. Setcolor can also set the reverse 
video and graphics character colors. Setcolor with no arguments 
produces a usage message that displays all available colors, then 
resets the screen to its previous state. 


For example, the following strings are possible colors. (Colors on 
your particular machine may be different.) 


blue magenta brown black 
It_blue magenta yellow gray 
cyan white It_green red 
It_cyan hi_white green It_red 


The following flags are available. In the arguments below, “color” 
is taken from the above list. 


—n 
Set the screen to ‘“‘normal’’ white characters on black back-— 
ground. 


color [color] 
Set the foreground to the first color. Sets background to second 
color if a second color choice is specified. 


—b color 
Set the background to the specified color. 


—r color color , 
Set the foreground reverse video characters to the first color. 
Set reverse video characters’ background to second color. 


—g color color 
Set the foreground graphics characters to the first color. Set 


graphics characters’ background to second color. 
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Notes 


Occasionally changing the screen color can help prolong the life of 
your monitor. 


setcolor has no effect on monochrome monitors. 
See Also 


console(M) 
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Name 


setmnt — Establishes /etc/mnttab table. 


Syntax 


/etc/setmnt 


Description 
Setmnt creates the /etc/mnttab table (see mnttab(F)), which is 
needed for both the mount(C) and umount(C) commands. Setmnt 
reads the standard input and creates a mnttab entry for each line. 
Input lines have the format: 
filesys node 

where filesys is the name of the file system’s special file (e.g., 
“hdO”’) and node is the root name of that file system. Thus filesys 
and node become the first two strings in the muttab(F) entry. 


Files 


/etc/mnttab 


See Also 


mnttab(F) 


Notes 
If filesys or node are longer than 128 characters, errors can occur. 


Setmnt silently enforces an upper limit on the maximum number of 
mnttab entries. 


Setmnt is normally invoked by /ete/re when the system boots up. 
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Name 


settime — Changes the access and modification dates of files. 


Syntax 


settime mmddhhmm | yy ][ —f fname ] name ... 


Description 


Sets the access and modification dates for one or more files. The 
dates are set to the specified date, or to the access and modifica- 
tion dates of the file specified via —f. Exactly one of these 
methods must be used to specify the new date(s). The first mm is 
the month number; dd is the day number in the month; hh is the 
hour number (24 hour system); the second mm is the minute 
number; yy is the last two digits of the year and is optional. For 
example: 


settime 1008004583 ralph pete 


sets the access and modification dates of files ralph and pete to Oct 
8, 12:45 AM, 1983. Another example: 


settime —f ralph john 


This sets the access and modification dates of the file john to those 
of the file ralph. 


Notes 


Use of touch in place of settime is encouraged. 
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Name 


sh — Invokes the shell command interpreter. 


Syntax 


sh | -ceiknrstuvx | [ args | 


Description 


The shell is the standard command programming language that exe- 
cutes commands read from a terminal or a file. See Invocation 
below for the meaning of arguments to the shell. 


Commands 


A simple-command is a sequence of nonblank words separated by 
blanks (a blank is a tab or a space). The first word specifies the 
name of the command to be executed. Except as specified below, 
the remaining words are passed as arguments to the invoked com- 
mand. The command name is passed as argument 0 (see exec(S)). 
The value of a simple-command is its exit status if it terminates nor- 
mally, or (octal) 1000+status if it terminates abnormally (i.e., if the 
failure produces a core file). See signal(S) for a list of status values. 


A pipeline is a sequence of one or more commands separated by a 
vertical bar (|). (The caret (*), also has the same effect.) The 
standard output of each command but the last is connected by a 
pipe(S) to the standard input of the next command. Each com- 
mand is run as a separate process; the shell waits for the last com- 
mand to terminate. 


A list is a sequence of one or more pipelines separated by ;, &, 
&&, or ||, and optionally terminated by ; or &. Of these four sym- 
bols, ; and & have equal precedence, which is lower than that of 
&& and ||. The symbols && and || also have equal precedence. 
A semicolon (;) causes sequential execution of the preceding pipe- 
line; an ampersand (&) causes asynchronous execution of the 
preceding pipeline (i.e., the shell does not wait for that pipeline to 
finish). The symbol && (|| ) causes the list following it to be exe- 
cuted only if the preceding pipeline returns a zero (nonzero) exit 
status. An arbitrary number of newlines may appear in a list, 
instead of semicolons, to delimit commands. 


August 26, 1985 Page 1 


SH (C) SH (C) 


A command is either a simple-command or one of the following 
commands. Unless otherwise stated, the value returned by a com- 
mand is that of the last simple-command executed in the command: 


for name [ in word ... | do list done 
Each time a for command is executed, name is set to the next 
word taken from the in word list. . If inword is omitted, then the 
for command executes the do list once for each positional 
parameter that is set (see Parameter Substitution below). Execu- 
tion ends when there are no more words in the list. 


case word in[ pattern [ | pattern | ix PHS SS, 1 oo 2 OSM 
A case command executes the list associated with the first pat- 
tern that matches word. The form of the patterns is the same as 
that used for filename generation (see Filename Generation 
below). 


if list then list [ elif list then list |... [ else list | fi 
The list following if is executed and, if it returns a zero exit 
status, the list following the first then is executed. Otherwise, 
the list following elif is executed and, if its value is zero, the list 
following the next then is executed. Failing that, the else Jist is 
executed. If no else list or then list is executed, then the if 
command returns a zero exit status. 


while list do list done 
A while command repeatedly executes the while Jist and, if the 
exit status of the last command in the list is zero, executes the 
do list: otherwise the loop terminates. If no commands in the 
do list are executed, then the while command returns a zero exit 
status; until may be used in place of while to negate the loop 
termination test. 


(list) 
Executes list in a subshell. 


{list;} 


list is simply executed. 


The following words are recognized only as the first word of a com- 
mand and when not quoted: 


‘f then else elif fi case esac for while until do done { } 
Comments 


A word beginning with # causes that word and all the following 
characters up to a newline to be ignored. 
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Command Substitution 


The standard output from a command enclosed in a pair of grave 
accents (**) may be used as part or all of a word; trailing newlines 
are removed. 


Parameter Substitution 


The character $ is used to introduce substitutable parameters. Posi- 
tional parameters may be assigned values by set. Variables may be 
set by writing: 


name=value | name=value |... 
Pattern-matching is not performed on value. 


${parameter } 

A parameter is a sequence of letters, digits, or underscores (a 
name), a digit, or any of the characters *, @, #, ?, -, $, and !. 
The value, if any, of the parameter is substituted. The braces 
are required only when parameter is followed by a letter, digit, 
or underscore that is not to be interpreted as part of its name. 
A name must begin with a letter or underscore. If parameter is 
a digit then it is a positional parameter. If parameter is * or @, 
then all the positional parameters, starting with $1, are substi- 
tuted (separated by spaces). Parameter $0 is set from argument 
zero when the shell is invoked. 


${parameter:-word } 
If parameter is set and is not a null argument, substitute its 
value; otherwise substitute word. 


${parameter:=word } 
If parameter is not set or is null, then set it to word; the value 
of the parameter is then substituted. Positional parameters may 
not be assigned to in this way. 


${parameter:?word } 
If parameter is set and is not a null argument, substitute its 
value; otherwise, print word and exit from the shell. If word is 
omitted, the message “parameter null or not set” is printed. 


${parameter:+word } 
If parameter is set and is not a null argument, substitute word; 
otherwise substitute nothing. In the above, word is not 
evaluated unless it is to be used as the substituted string, so that 
in the following example, pwd is executed only if d is not set or 
is null: | 
echo ${d:-spwd*} 
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If the colon (:) is omitted from the above expressions, then the 
shell only checks whether parameter is set. 


The following parameters are automatically set by the shell: 
# The number of positional parameters in decimal 
- Flags supplied to the shell on invocation or by the set command 


? The decimal value returned by the last synchronously executed 
command 


$ The process number of this shell 
! The process number of the last background command invoked 
The following parameters are used by the shell: 


HOME 
The default argument (home directory) for the cd command 


PATH \ 
The search path for commands (see Execution below) 


MAIL 
If this variable is set to the name of a mail file, then the shell 
informs the user of the arrival of mail in the specified file 


PS1 
Primary prompt string, by default “$ ” 


PS2 
Secondary prompt string, by default “> ” 


IFS 
Internal field separators, normally space, tab, and newline 


The shell gives default values to PATH, PS1, PS2, and IFS, while 
HOME and MAIL are not set at all by the shell (although HOME is 
set by login(M)). 


Blank Interpretation 


After parameter and command substitution, the results of substitu- 
tion are scanned for internal field separator characters (those found 
in IFS) and split into distinct arguments where such characters are 
found. Explicit null arguments ("" or **) are retained. Implicit 
null arguments (those resulting from parameters that have no 
values) are removed. 
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Filename Generation 


Following substitution, each command word is scanned for the 
characters *, ?, and [. If one of these characters appears, the 
word is regarded as a pattern. The word is replaced with alphabeti- 
cally sorted filenames that match the pattern. If no filename is 
found that matches the pattern, the word is left unchanged. The 
character . at the start of a filename or immediately following a /, 
as well as the character / itself, must be matched explicitly. These 
characters and their matching patterns are: 


* Matches any string, including the null string. 


2? Matches any single character. 


Matches any one of the enclosed characters. A pair of charac- 
ters separated by - matches any character lexically between the 
pair, inclusive. If the first character following the opening 
bracket ([) is an exclamation mark (!), then any character not 
enclosed is matched. 


Quoting 


The following characters have a special meaning to the shell and 
Cause termination of a word unless quoted: 


; & ( ) | * < > newline space tab 


A character may be quoted (i.e., made to stand for itself) by 
preceding it with a \, The pair \newline is ignored. All characters 
enclosed between a pair of single quotation marks (’”), except a 
single quotation mark, are quoted. Inside double quotation marks 
(“"), parameter and command substitution occurs and \ quotes the 


characters \, -» and $.. 7S?" is souwalent to "$1 $2. ...."; 
whereas ‘‘$@”’ is equivalent to "$1" "$2" ... 


Prompting 
When used interactively, the shell prompts with the value of PS1 
before reading a command. If at any time a newline is typed and 


further input is needed to complete a command, the secondary 
prompt (i.e., the value of PS2) is issued. 
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Spelling Checker 


When using cd(C) the shell checks spelling. For example, if you 
change to a different directory using cd and misspell the directory 
name, the shell repsonds with an alternative spelling of an existing 
directory. Enter ‘“y” and press RETURN to change to the offered 
directory, or retype the command line if the offered spelling is 


incorrect. In this example the sh(C) repsonse is boldfaced. 


$ cd /usr/spol/uucp 
cd /usr/spool/uucp?y 
ok 


Input/Output 


Before a command is executed, its input and output may be 
redirected using a special notation interpreted by the shell. The fol- 
lowing may appear anywhere in a simple-command or may precede 
or follow a command. They are not passed on to the invoked com- 
mand; substitution occurs before word or digit is used: 


<word Use file word as standard input (file descriptor 0). 


>word Use file word as standard output (file descriptor 1). 
If the file does not exist, it is created; otherwise, it 
is truncated to zero length. 


>> word Use file word as standard output. If the file exists, 
output is appended to it (by first seeking the end- 
of-file); otherwise, the file is created. 


<<[-]word The shell input is read up to a line that is the same 
as word, or to an end-of-file. The resulting docu- 
ment becomes the standard input. If any character 
of word is quoted, no interpretation is placed upon 
the characters of the document; otherwise, parame- 
ter and command substitution occurs, (unescaped) 
\newline is ignored, and \ must be used to quote the 
characters \ $. *, and the first character of word. 
If - is appended to <<, all leading tabs are stripped 
from word and from the document. 


<&digit The standard input is duplicated from file descriptor 
digit (see dup(S)). Similarly for the standard output 
using >. 

<&- The standard input is closed. Similarly for the stan- 


dard output using >. 
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If one of the above is preceded by a digit, the file descriptor 
created is that specified by the digit (instead of the default O or 1). 
For example: 


Sex reel 
creates file descriptor 2 that is a duplicate of file descriptor 1. 


If a command is followed by & , the default standard input for the 
command is the empty file /dev/null. Otherwise, the environment 
for the execution of a command contains the file descriptors of the 
invoking shell as modified by input/output specifications. 


Environment. 


The environment (see environ(M)) is a list of name-value pairs that 
is passed to an executed program in the same way as a normal argu- 
ment list. The shell interacts with the environment in several ways. 
On invocation, the shell scans the environment and creates a 
parameter for each name found, giving it the corresponding value. 
Executed commands inherit the same environment. If the user 
modifies the values of these parameters or creates new ones, none 
of these affect the environment unless the export command is used 
to bind the shell’s parameter to the environment. The environment 
seen by any executed command is composed of any unmodified 
name-value pairs originally inherited by the shell, plus any 
modifications or additions, all of which must be noted in export 
commands. 


The environment for any simple-command may be augmented by 
prefixing it with one or more assignments to parameters. Thus: 


TERM=450 cmd args 
and 

(export TERM; TERM=450; cmd args) 
are equivalent (as far as the above execution of cmd is concerned). 
If the -k flag is set, all keyword arguments are placed in the 
environment, even if they occur after the command name. 
Signals 
The INTERRUPT and QUIT signals for an invoked command are 
ignored if the command is followed by &; otherwise signals have 


the values inherited by the shell from its parent, with the exception 
of signal 11. See the trap command below. 
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Execution 


Each time a command is executed, the above substitutions are car- 
ried out. Except for the Special Commands listed below, a new 
process is created and an attempt is made to execute the command 
via exec(S). 


The shell parameter PATH defines the search path for the directory 
containing the command. Alternative directory names are 
separated by a colon (:). The default path is :/bin:/usr/bin (speci- 
fying the current directory, /bin, and /usr/bin, in that order). Note 
that the current directory is specified by a null pathname, which 
can appear immediately after the equal sign or between the colon 
delimiters anywhere else in the path list. If the command name 
contains a /, then the search path is not used. Otherwise, each 
directory in the path is searched for an executable file. If the file 
has execute permission but is not an a.out file, it is assumed to be a 
file containing shell commands. A subshell (i.e., a separate pro- 
cess) is spawned to read it. A parenthesized command is also exe- 
cuted in a subshell. 


Shell procedures are often used by users running the csh . How- 
ever, if the first character of the procedure is a # (comment charac- 
ter), the csh assumes the procedure is a esh script, and invokes 
/bin/csh to execute it. Always start sh procedures with some other 
character if csh users are to run the procedure at any time. This 
invokes the standard shell /bin/sh . 


Special Commands 


The following commands are executed in the shell process and, 
except as specified, no input/output redirection is permitted for 
such commands: 


No effect; the command does nothing. A zero exit code is 
returned. 


. file 
Reads and executes commands from file and returns. The 
search path specified by PATH is used to find the directory con- 
taining file. 


break [ 7 | 
Exits from the enclosing for or while loop, if any. If 7 is 
specified, it breaks 7 levels. 


continue [ 7 | 


Resumes the next iteration of the enclosing for or while loop. If 
n is specified, it resumes at the n-th enclosing loop. 
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cd [ arg | 

Changes the current directory to arg. The shell parameter 
HOME is the default arg. The shell parameter CDPATH defines 
the search path for the directory containing arg. Alternative 
directory names are separated by a colon (:). The default path 
is <null> (specifying the current directory). Note that the 
current directory is specified by a null path name, which can 
appear immediately after the equal sign or between the colon 
delimiters anywhere else in the path list. If arg begins with a /, 
the search path is not used. Otherwise, each directory in the 
path is searched for arg. 


If the shell is reading its commands from a terminal, and the 
specified directory does not exist (or some component cannot be 
searched), spelling correction is applied to each component of 
directory, in a search for the “correct” name. The shell then asks 
whether or not to try and change directory to the corrected direc- 
tory name; an answer of n means “no”, and anything else is taken 
as “‘yes’’. 


eval [ arg... | 
The arguments are read as input to the shell and the resulting 
command(s) executed. 


exec [ arg... | 
The command specified by the arguments is executed in place of 
this shell without creating a new process. Input/output argu- 
ments may appear and, if no other arguments are given, cause 
the shell input/output to be modified. 


exit [ 1 | 
Causes a shell to exit with the exit status specified by n. If n is 
omitted, the exit status is that of the last command executed. 
An end-of-file will also cause the shell to exit. 


export [ name... | 
The given names are marked for automatic export to the 
environment of subsequently executed commands. If no argu- 
ments are given, a list of all names that are exported in this shell 
is printed. 


newegrp [ arg... | 
Equivalent to exec newgrp arg... 


read [ name... | 
One line is read from the standard input and the first word is 
assigned to the first name, the second word to the second name, 
etc., with leftover words assigned to the last name. The return 
code is 0 unless an end-of-file is encountered. 
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readonly [ name... | 
The given names are marked readonly and the values of the 
these names may not be changed by subsequent assignment. If 
no arguments are given, a list of all readonly names is printed. 


set [ -eknuvx[ arg... | | 


-e If the shell is noninteractive, exits immediately if a command 
exits with a nonzero exit status. 


-k Places all keyword arguments in the environment for a com- 
mand, not just those that precede the command name. 


-n Reads commands but does not execute them. 
-u Treats unset variables as an error when substituting. 
-v Prints shell input lines as they are read. 


-x Prints commands and their arguments as they are executed. 
Although this flag is passed to subshells, it does not enable 
tracing in those subshells. 


-- Does not change any of the flags; useful in setting $1 to -. 


Using + rather than - causes these flags to be turned off. These 
flags can also be used upon invocation of the shell. The current 
set of flags may be found in $-. The remaining arguments are 
positional parameters and are assigned, in order, to $1, $2, ... 
If no arguments are given, the values of all names are printed. 


shift 
The positional parameters from $2... are renamed $1... 


test 
Evaluates conditional expressions. See test(C) for usage and 
description. 


times 
Prints the accumulated user and system times for processes run 
from the shell. 


trap [ arg |[ 7 ]... 
arg is a command to be read and executed when the shell 


receives signal(s) n. (Note that arg is scanned once when the 
trap is set and once when the trap is taken.) Trap commands 
are executed in order of signal number. The highest signal 
number allowed is 16. Any attempt to set a trap on a signal that 
was ignored on entry to the current shell is ineffective. An 
attempt to trap on signal 11 (memory fault) produces an error. 
If arg is absent, all trap(s) n are reset to their original values. If 
arg is the null string, this signal is ignored by the shell and by 
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the commands it invokes. If n is 0, the command arg is exe- 
cuted on exit from the shell. The trap command with no argu- 
ments prints a list of commands associated with each signal 
number. 


ulimit [[ -f ] 7 | 
imposes a size limit of n blocks on files. 


-f imposes a size limit of n blocks on files written by child 
processes (files of any size may be read). Any user may 
decrease the file size limit, but only the super-user (root) can 
increase the limit. With no argument, the current limit is 
printed. 


If no option is given and a number is specified, -f is assumed. 


umask [ ooo | 
The user file-creation mask is set to the octal number ooo where 
o is an octal digit (see umask(C)). If ooo is omitted, the 
current value of the mask is printed. 


wait [ n | 
Waits for the specified process to terminate, and reports the ter- 
mination status. If m is not given, all currently active child 
processes are waited for. The return code from this command 
is always 0. 


Invocation 


If the shell is invoked through exec(S) and the first character of 
argument 0 is -, commands are initially read from /etc/profile and 
then from $HOME/.profile, if such files exist. Thereafter, com- 
mands are read as described below, which is also the case when the 
shell is invoked as /bin/sh. The flags below are interpreted by the 
shell on invocation only; note that unless the -e or -s flag is 
specified, the first argument is assumed to be the name of a file 
containing commands, and the remaining arguments are passed as 
positional parameters to that command file: 


-c string If the -c flag is present, commands are read from String. 


-S If the -s flag is present or if no arguments remain, com- 
mands are read from the standard input. Any remaining 
arguments specify the positional parameters. Shell out- 
put is written to file descriptor 2. 


-t If the -t flag is present, a single command is read and 


executed, and the shell exits. This flag is intended for 
use by C programs only and is not useful interactively. 
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-j If the -i flag is present or if the shell input and output 
are attached to a terminal, this shell is interactive. In 
this case, TERMINATE is ignored (so that kill 0 does 
not kill an interactive shell) and INTERRUPT is caught 
and ignored (so that wait is interruptible). In all cases, 
QUIT is ignored by the shell. 


-r If the -r flag is present, the shell is a restricted shell (see 


rsh(C)). 


The remaining flags and arguments are described under the set 
command above. 


Exit Status 


Errors detected by the shell, such as syntax errors, cause the shell 
to return a nonzero exit status. If the shell is being used nonin- 
teractively, execution of the shell file is abandoned. Otherwise, the 
shell returns the exit status of the last command executed. See the 
exit command above. 


Files 


/etc/profile 
$HOME/.profile 
/tmp/sh* 
/dev/null 


See Also 
cd(C), env(C), login(M), newgrp(C), rsh(C), test(C), umask(C), 
dup(S), exec(S), fork(S), pipe(S), signal(S), umask(S), wait(S), 
a.out(F), profile(M), environ(M) 

Notes 


The command readonly (without arguments) produces the same 
output as the command export. 


If << is used to provide standard input to an asynchronous process 
invoked by &, the shell gets mixed up about naming the input docu- 
ment; a garbage file /tmp/sh* is created and the shell complains 
about not being able to find that file by another name. 
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Name 


shutdown — Terminates all processing. 


Syntax 


/etc/shutdown [ time | [ su | 


Description 


Shutdown is part of the XENIX operation procedures. Its primary 
function is to terminate all currently running processes in an orderly 
and cautious manner. The time argument is the number of minutes 
before a shutdown will occur. The optional su argument lets the 
user go single-user, without completely shutting down the system. 
However, the system is shut down for multi-user use. Shutdown 
goes through the following steps. First, all users logged on the sys- 
tem are notified to log off the system by a broadcasted message. 
All file system super-blocks are updated before the system is 
stopped (see sync(C)). This must be done before rebooting the sys- 
tem, to insure file system integrity. 


See Also 


sync(C), umount(C), wall(C) 


Diagnostics 
The most common error diagnostic that will occur is device busy. 


This diagnostic appears when a particular file system could not be 
unmounted. See umount(C). 


Notes 
Once shutdown has been invoked, it must be allowed to run to 
completion and must not be interrupted by pressing BREAK or 


DEL. 


Shutdown does not lock the hard disk heads. 
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Name 


shV — Invokes the shell command interpreter. 


Syntax 


shV [| —ceiknrstuvx ] [ args ] 


Description 


The shell is the standard command programming language that exe- 
cutes commands read from a terminal or a file. See Invocation 
below for the meaning of arguments to the shell. 


Commands 


A simple—command is a sequence of nonblank words separated by 
blanks (a blank is a tab or a space). The first word specifies the 
name of the command to be executed. Except as specified below, 
the remaining words are passed as arguments to the invoked com- 
mand. The command name is passed as argument 0 (see exec(S)). 
The value of a simple-command is its exit status if it terminates 
normally, or (octal) 1000+starus if it terminates abnormally (i.e., if 
the failure produces a core file). See signal(S) for a list of status 
values. 


A pipeline is a sequence of one or more commands separated by a 
vertical bar (|). (The caret ( ), also has the same effect.) The 
Standard output of each command but the last is connected by a 
pipe(S) to the standard input of the next command. Each com- 
mand is run as a separate process; the shell waits for the last com- 
mand to terminate. 


A list is a sequence of one or more pipelines separated by ;, &, 
&&, or||, and optionally terminated by ; or &. Of these four sym- 
bols, ; and & have equal precedence, which is lower than that of 
&& and||. The symbols && and || also have equal precedence. A 
semicolon (;) causes sequential execution of the preceding pipeline: 
an ampersand (&) causes asynchronous execution of the preceding 
pipeline (i.e., the shell does nor wait for that pipeline to finish). 
The symbol && (|| ) causes the list following it to be executed only 
if the preceding pipeline returns a zero (nonzero) exit status. An 
arbitrary number of newiines may appear in a list, instead of semi-— 
colons, to delimit commands. 
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A command is either a simple-command or one of the following 
commands. Unless otherwise stated, the value returned by a com- 
mand is that of the last simple-command executed in the com- 
mand: 
for name [ in word ... | do list done 
Each time a for command is executed, name is set to the next 
word taken from the in word list. If in word is omitted, then 
the for command executes the do list once for each positional 
parameter that is set (see Parameter Substitution below). Execu- 
tion ends when there are no more words in the list. 


case word in [ pattern [ | pattern |...) list 5; ]... esac 
A case command executes the list associated with the first 
pattern that matches word. The form of the patterns is the 
same as that used for filename generation (see Filename Genera 
tion below). 


if list then list [ elif list then list ]...[ else list | fi 
The list following if is executed and, if it returms a zero exit 
status, the list following the first then is executed. Otherwise, 
the list following elif is executed and, if its value is zero, the list 
following the next then is executed. Failing that, the else Jisr is 
executed. If no else dist or then list is executed, then the if 
command returns a zero extt Status. 


while list do list done 
A while command repeatedly executes the while list and, if the 
exit status of the last command in the list is zero, executes the 
do list; otherwise the loop terminates. If no commands in the 
do list are executed, then the while command returns a zero exit 
status; until may be used in place of while to negate the loop 
termination test. 


(list) 
Executes list in a subshell. 


{list;} 
list is simply executed. 
name () {list;} 
Define a function which is referenced by name. The body of 


functions is the list of commands between { and }. Execution 
of functions is described below (see Execution.) 


The following words are recognized only as the first word of a com- 
mand and when not quoted: 


if then else elif fi case esac for while until do done { } 
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Comments 


A word beginning with # causes that word and all the following 
characters up to a newline to be ignored. 


Command Substitution 


The standard output from a command enclosed in a pair of grave 
accents (**) may be used as part or all of a word; trailing newlines 
are removed. 


Parameter Substitution 


The character $ is used to introduce substitutable parameters. Posi- 
tional parameters may be assigned values by set. Vamables may be 
set by writing: 


name=value [ name=value |... 
Pattern—matching is not performed on value. 


${ parameter } 

A parameter is a sequence of letters, digits, or underscores (a 
name), a digit, or any of the characters *, @, #, ?, —, $, and ‘¢. 
The value, if any, of the parameter is substituted. The braces 
are required only when parameter is followed by a letter, digit, 
or underscore that’is not to be interpreted as part of its name. 
A-name must begin with a letter or underscore. If parameter is 
a digit then it is a positional parameter. If parameter is * or @, 
then all the positional parameters, starting with $1, are substi- 
tuted (separated by spaces). Parameter $0 is set from argument 
zero when the shell is invoked. 


${parameter:=word } 
If parameter is set and is not a null argument, substitute its 
value; otherwise substitute word. 


${parameter:=word } 
If parameter is not set or is null, then set it to word; the value 
of the parameter is then substituted. Positional parameters may 
not be assigned to in this way. 


${parameter:2word } | 
If parameter is set and is not a null argument, substitute its 
value; otherwise, print word and exit from the shell. If word is 
omitted, the message “‘parameter null or not set” is printed. 
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${parameter:+word } 


If parameter is set and is not a null argument, substitute word; 
otherwise substitute nothing. In the above, word is not 
evaluated unless it is to be used as the substituted string, so that 
in the following example, pwd is executed only if d is not set or 
is null: 

echo ${d:-—*pwd*} 


If the colon (:) is omitted from the above expressions, then the 
shell only checks whether parameter is set. 


The following parameters are automatically set by the shell: 


# 


Lp 
e 


$ 


: 


The number of positional parameters in decimal 
Flags supplied to the shell on invocation or by the set command 


The decimal value returned by the last synchronously executed 
command 


The process number of this shell 


The process number of the last background command invoked 


The following parameters are used by the shell: 


HOME 


The default argument (home directory) for the cd command 


PATH 


The search path for commands (see Execution below) 


MAIL 


If this variable is set to the name of a mail file, then the shell 
informs the user of the arrival of mail in the specified file 


MAILCHECK 


This parameter specifies how often (in seconds) the shell will 
check for the arrival of mail in the files specified by the 
MAILPATH or MAIL parameters. The default value is 600 
seconds (10 minutes). If set to 0, the shell will check before 
each prompt. 


MAILPATH 


A colon (:) separated list of file names. If this parameter is set, 
the shell informs the user of the arrival of mail in any of the 
specified files. Each file name can be followed by % and a mes- 
sage that will be printed when the modification time changes. 
The default message is vou have mail. 
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PS1 
Primary prompt string, by default “$ ”’ 


PS2 
Secondary prompt string, by default “> ” 
IFS 
Internal field separators, normally space, tab, and newline 


SHACCT 
If this parameter is set to the name of a file wntable by the user. 
the shell will write an accounting record in the file for each she 
procedure executed. Accounting routines such as acctcom(¢ | 
and accton(C) can be used to anaylze the data collected. 


SHELL 
When the shell is invoked, it scans the environment (see 
Environment below) for this name. If it is found and there 1s an 
‘r’ in the file name part of its value, the shell becomes a res- 
tricted shell. 


The shell gives default values to PATH, PS1, PS2, and IFS, while 
HOME and MAIL are not set at all by the shell (although HOME 1s 
set by login(M)). 


Blank Interpretation 


After parameter and command substitution, the results of substitu- 
tion are scanned for internal field separator characters (those found 
in IFS) and split into distinct arguments where such characters are 
found. Explicit null arguments ("" or °*) are retained. Implicit 
null arguments (those resulting from parameters that have no 
values) are removed. 


Filename Generation 


Following substitution, each command word is scanned for the 
characters *, ?, and [. If one of these characters appears, the word 
is regarded as a pattern. The word is replaced with alphabetically 
sorted filenames that match the pattern. If no filename is found 
that matches the pattern, the word is left unchanged. The charac- 
ter . at the start of a filename or immediately following a /, as well 
as the character / itself, must be matched explicitly. These charac- 
ters and their matching patterns are: 


* Matches any string, including the null string. 


2 Matches any single character. 


January 27, 1986 Page 5 


SHV {2 ) SHV (C) 


ee 
Matches any one of the enclosed characters. A pair of charac- 
ters separated by — matches any character lexically between the 
pair, inclusive. If the first character following the opening 
bracket ([) is an exclamation mark (!), then any character not 
enclosed is matched. 


Quoting 


The following characters have a special meaning to the shell and 
cause termination of a word unless quoted: 


- & ()|° < > newline space tab 


A character may be quoted (i.e., made to stand for itself) by 
preceding it with a \. The pair \newline is ignored. All characters 
enclosed between a pair of single quotation marks (’*), except a 
single quotation mark, are quoted. Inside double quotation marks 
(""), parameter and command substitution occurs and \ quotes the 
characters \, *, ", and $. "$=" is equivalent to "$1 $2 ...", whereas 
““$@”’ is equivalent to "$1" “$2" ... 


Prompting 


When used interactively, the shell prompts with the value of PS1 
before reading a command. If at any time a newline is typed and 
further input is needed to complete a command, the secondary 
prompt (i.e., the value of PS2) 1s issued. 


Spelling Checker 


When using cd(C) the shell checks spelling. For example, if you 
change to a different directory using cd and misspell the directory 
name, the shell repsonds with an alternative spelling of an existing 
directory. Enter ‘‘y” and press RETURN to change to the offered 
directory, or retype the command line if the offered spelling is 
incorrect. In this example the shV(C) response is boldfaced. 


$ cd /usr/spol/uucp 
cd /usr/spool/uucp ?y 
ok 


Input/Output 


Before a command is executed, its input and output may be 
redirected using a special notation interpreted by the shell. The fol- 
lowing may appear anywhere in a simple-command or may precede 
or follow a command. They are not passed on to the invoked com- 
mand: substitution occurs before word or digit is used: 
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<word Use file word as standard input (file descriptor 0). 


> word Use file word as standard output (file descriptor 1). 
If the file does not exist, it is created; otherwise, it 
is truncated to zero length. 


>> word Use file word as standard output. If the file exists, 
Output is appended to it (by first seeking the 
end-of-file); otherwise, the file is created. 


<<[=—]word The shell input is read up to a line that is the same 
as word, or to an end-of-file. The resulting docu- 
ment becomes the standard input. If any character 
of word is quoted, no interpretation is placed upon 
the characters of the document; otherwise, parame- 
ter and command substitution occurs, (unescaped) 
\newline is ignored, and \ must be used to quote the 
characters \, $, *, and the first character of word. 
If — is appended to <<, all leading tabs are stripped 
from word and from the document. 


< &digit The standard input is duplicated from file descriptor 
digit (see dup(S)). Similarly for the standard output 
using >. 

<&= The standard 1::put is closed. Similarly for the stan- 


dard output using >. 


If one of the above is preceded by a digit, the file descnptor 
created is that specified by the digit (instead of the default O or 1). 
For example: 


« Roark 
creates file descriptor 2 that 1s a duplicate of file descriptor 1. 


If a command is followed by & , the default standard input for the 
command is the empty file /dev/null. Otherwise, the environment 
for the execution of a command contains the file descnptors of the 
invoking shell as modified by input/output specifications. 


Environment 


The environment (see environ(M)) is a list of name-value pairs that 
is passed to an executed program in the same way as a normal argu- 
ment list. The shell interacts with the environment in several ways. 
On invocation, the shell scans the environment and creates a 
parameter for each name found, giving it the corresponding value. 
Executed commands inherit the same environment. If the user 
modifies the values of these parameters or creates new ones, none 
of these affect the environment unless the export command is used 
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to bind the shell’s parameter to the environment. The environment 
seen by any executed command is composed of any unmodified 
name-value pairs originally inherited by the shell, minus any pairs 
removed by unset, plus any modifications or additions, all of which 
must be noted in export commands. 


The environment for any simple—command may be augmented by 
prefixing it with one or more assignments to parameters. Thus: 


TERM=450 cmd args 
and 
(export TERM; TERM=450; cmd args) 
are equivalent (as far as the above execution of cmd is concerned). 


If the —k flag is set, all keyword arguments are placed in the 
environment, even if they occur after the command name. 


Signals 


The INTERRUPT and QUIT signals for an invoked command are 
ignored if the command is followed by &; otherwise signals have 
the values inherited by the shell from its parent, with the exception 
of signal 11. See the trap command below. 


Execution 


Each time a command is executed, the above substitutions are car- 
ried out. Except for the Special Commands listed below, a new 
process is created and an attempt is made to execute the command 
via exec(S). 


The shell parameter PATH defines the search path for the directory 
containing the command. Alternative directory names are 
separated by a colon (:). The default path is :/bin:/usr/bin (speci— 
fying the current directory, /bin, and /usr/bin, in that order). Note 
that the current directory is specified by a null pathname, which 
can appear immediately after the equal sign or between the colon 
delimiters anywhere else in the path list. If the command name 
contains a /, then the search path is not used. Otherwise, each 
directory in the path is searched for an executable file. If the file 
has execute permission but is not an a.out file, it is assumed to be a 
file containing shell commands. A subshell (i.e., a separate pro- 
cess) is spawned to read it. A parenthesized command is also exe- 
cuted in a subshell. 
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Shell procedures are often used by users running the esh . How- 
ever, if the first character of the procedure is a # (comment charac- 
ter), the csh assumes the procedure is a esh script, and invokes 
/bin/csh to execute it. Always start sh procedures with some other 
character if csh users are to run the procedure at any time. This 
invokes the standard shell /bin/sh . 


The location in the search path where a command was found is 
remembered by the shell (to help avoid unnecessary execs later). If 
the command was found in a relative directory, its location must be 
re—determined whenever the current directory changes. The shell 
forgets all remembered locations whenever the PATH variable is 
changed or the hash —r command is executed (see below). 


Special Commands 
Input/output redirection is now permitted for these commands: 


No effect; the command does nothing. A zero exit code 1s 
returned. 


. file | 
Reads and executes commands from file and returns. The 
search path specified by PATH is used to find the directory con- 


taining file. 


break [ 7 |] 
Exits from the enclosing for or while loop, if any. If 7 1s 
specified, it breaks n levels. 


continue [ 7 | 
Resumes the next iteration of the enclosing for or while loop. If 
n is specified, it resumes at the n-th enclosing loop. 


ed [ arg | 

Changes the current directory to arg. The shell parameter 
HOME is the default arg. The shell parameter CDPATH defines 
the search path for the directory containing arg. Alternative 
directory names are separated by a colon (:). The default path 
is <null> (specifying the current directory). Note that the 
current directory is specified by a null path name, which can 
appear immediately after the equal sign or between the colon 
delimiters anywhere else in the path list. If arg begins with a /, 
the search path is not used. Otherwise, each directory in the 
path 1s searched for arg. 
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If the shell is reading its commands from a terminal, and the 
specified directory does not exist (or some component cannot be 
searched), spelling correction is applied to each component of 
directory, in a search for the “correct” name. The shell then asks 
whether or not to try and change directory to the corrected direc- 
tory name; an answer of mn means “no”, and anything else is taken 
as “yes”. 


eval [ arg... | 
The arguments are read as input to the shell and the resulting 
command(s) executed. 


exec [ arg... | 
The command specified by the arguments is executed in place of 
this shell without creating a new process. Input/output argu- 
ments may appear and, if no other arguments are given, cause 
the shell input/output to be modified. 


exit [7 |] 
Causes a shell to exit with the exit status specified by 1. If n is 
omitted, the exit status is that of the last command executed. 
An end-of-file will also cause the shell to exit. 


export [| name... | 
The given mames are marked for automatic export to the 
environment of subsequently executed commands. If no argu- 
ments are given, a list of all names that are exported in this shell 
is printed. 


hash[ <r ][ name... | 

For each name, the location in the search path of the command 
specified by name is determined and remembered by the shell. 
The =r option causes the shell to forget all remembered loca- 
tions. If no arguments are given, information about remem- 
bered commands is presented. Hits is the number of times a 
command has been invoked by the shell process. Cost is a 
measure of the work required to locate a command in the 
search path. There are certain situations which require that the 
stored location of a command be recalculated. Commands for 
which this will be done are indicated by an asterisk (*) adjacent 
to the hits information. Cost will be incremented when the 
recalculation is done. 


newgrp [ arg... | 
Equivalent to exec newgrp arg... 


pwd 


Print the current working directory. See pwd(C) for usage and 
description. 
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read {[ name... | 
One line is read from the standard input and the first word is 
assigned to the first name, the second word to the second name, 
etc., with leftover words assigned to the last name. The return 
code is 0 unless an end-of-file is encountered. 


readonly [| name... | 
The given names are marked readonly and the values of the 
these names may not be changed by subsequent assignment. If 
no arguments are given, a list of all readonly names is printed. 


return [ 7 | 
Causes a function to ext with the return value specified by 7. If 
mis omitted, the return status is that of the last command exe- 
cuted. 


set [ —eknuvx [ arg... ] |] 


= € 
If the shell is noninteractive, exits immediately if a command 
exits with a nonzero ext status. 


-f Disables file name generation. 


-h 
Locates and remembers fuction commands as function are 
defined (function commands are normally located when the 
function is executed). 


=k 
Places all keyword arguments in the environment for a com- 
mand, not just those that precede the command name. 


-n 
Reads commands but does not execute them. 


—uU 
Treats unset variables as an error when substituting. 


—V 
Prints shell input lines as they are read. 


xX 
Prints commands and their arguments as they are executed. 
Although this flag is passed to subshells, it does not enable 
tracing in those subshells. 


Does not change any of the flags; useful in setting $1 to -. 
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Using + rather than — causes these flags to be turned off. 
These flags can also be used upon invocation of the shell. The 
current set of flags may be found in $=. The remaining argu- 
ments are positional parameters and are assigned, in order, to 
$1, $2, ... If no arguments are given, the values of all names 
are printed. 


shift 
The positional parameters from $2... are renamed $1... 


test 
Evaluates conditional expressions. See test(C) for usage and 
description. 


times 
Prints the accumulated user and system times for processes run 
from the shell. 


trap [ arg }[ 7]... 

arg is a command to be read and executed when the shell 
receives signal(s) m. (Note that arg is scanned once when the 
trap is set and once when the trap is taken.) Trap commands 
are executed in order of signal number. The highest signal 
number allowed is 16. Any attempt to set a trap on a signal that 
was ignored on entry to the current shell is ineffective. An 
attempt to trap on signal 11 (memory fault) produces an error. 
If arg is absent, all tra;(s) m are reset to their original values. If 
arg is the null string, this signal is ignored by the sheil and by 
the commands it invokes. If n is 0, the command arg is exe- 
cuted on exit from the shell. The trap command with no argu- 
ments prints a list of commands associated with each signal 
number. 


type [ name ... | 
For each name, indicate how it would be interpreted if used as a 


command name. 


ulimit [[ -f ] 7 ] 
imposes a size limit of n blocks on files. 


—f imposes a size limit of m blocks on files wmitten by child 
processes (files of any size may be read). Any user may 
decrease the file size limit, but only the super—user (root) can 
increase the limit. With no argument, the curvent limit is 
printed. 


If no option is given and a number 1s specified, =f is assumed. 
unset { name ... | | | 
For each name, remove the corresponding variable or function. 


Teh variables PATH, PS1, PS2, MAILCHECK and IFS cannot be 
unset. 
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umask [ 000 | 
The user file-creation mask is set to the octal number ooo 
where o is an octal digit (see umask(C)). If ooo is omitted, the 
current value of the mask is pmnted. 


wait [ 7 |] 
Waits for the specified process to terminate, and reports the ter- 
mination status. If m is not given, all currently active child 
processes are waited for. The return code from this command 
is always 0. 


Invocation 


If the shell is invoked through exec(S) and the first character of 
argument 0 is =, commands are initially read from /etc/profile and 
then from $HOME/.profile, if such files exst. Thereafter, com- 
mands are read as described below, which is also the case when the 
shell is invoked as /bin/sh. The flags below are interpreted by the 
shell on invocation only; note that unless the —c or =s flag is 
specified, the first argument is assumed to be the name of a file 
containing commands, and the remaining arguments are passed as 
positional parameters to that command file: 


—c string If the =—c flag 1s present, commands are read from 
String . 


—S If the —s flag is present or if no arguments remain, com- 
mands are read from the standard input. Any remaining 
arguments specify the positional parameters. Shell out- 
put is written to file descriptor 2. 


=-t If the —t flag is present, a single command is read and 
executed, and the shell exits. This flag is intended for 
use by C programs only and is not useful interactively. 


| If the =i flag is present or if the shell input and output 
are attached to a terminal, this shell is interactive. In 
this case, TERMINATE is ignored (so that kill 0 does 
not kill an interactive shell) and INTERRUPT is caught 
and ignored (so that wait is interruptible). In all cases, 
QUIT is ignored by the shell. 


=r If the <r flag is present, the shell is a restricted shell 
(see rsh(C)). 


The remaining flags and arguments are descnbed under the set 
command above. 


January 27. 1986 Page 153 


SHV (C) SHV (C) 


Exit Status 


Errors detected by the shell, such as syntax errors, cause the shell 
to return a nonzero exit status. If the shell is being used nonin- 
teractively, execution of the shell file is abandoned. Otherwise, the 
shell returns the exit status of the last command executed. See the 
exit command above. 


Files 


/etc/profile 
SHOME/ . profile 
/tmp/sh* 
/dev/null 


See Also 


cd(C), env(C), login(M), newegrp(C), rsh(C), test(C), umask(C). 
dup(S), exec(S), fork(S), pipe(S), signal(S), umask(S), wait(S), 
a.out(F), profile(M), environ(M) 


Notes 


The command readonly (without arguments) produces the same 
output as the command export. 


If << is used to provide standard input to an synchronous process 
invoked by &, the shell gets mixed up about naming the input docu- 
ment; a garbage file /tmp/sh* 1s created and the shell complains 
about not being able to find that file by another name. 


If a command is executed, and a command with the same name is 
installed in a directory in the search path before the directory 
where the original command was found, the shell will continue to 
exec the original command. Use the hash command to correct this 
situation. 


If you move the current directory or one above it, pwd may not 


give the correct response. Use the ed command with a full path 
name to correct this situation. 
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Name 


sleep — Suspends execution for an interval. 


Syntax 


sleep time 


Description 


Sleep suspends execution for time seconds. It is used to execute a 
command after a certain amount of time as in: 


(sleep 105; command)& 


or to execute a command every so often, as in: 


while true 
do 
command 
sleep 3/ 
done 


See Also 


alarm(S), sleep(S) 


Notes 


Time must be less than 65536 seconds. 
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Name 


sort — Sorts and merges files. 


Syntax 


sort [-cmu] [-ooutput] [-ykmem] [-zrecsz] [-dfiMnr] [-btx] [+pos1] 
[-pos2] [files] 


Description 


Sort sorts lines of all the named files together and writes the result 
on the standard output. The standard input is read if - is used as a 
file name or if no input files are named. 


Comparisons are based on one or more sort keys extracted from 
each line of input. By default, there is one sort key, the entire 
input line, and ordering is lexicographic by bytes in the machine’s 
collating sequence. 


The following options alter the default behavior: 


-c Check that the input file is sorted according to the ordering 
rules; give no output unless the file is out of sort. 


-m Merge only, the input files are already sorted. 


-u- Unique: suppress all but one in each set of lines having equal 
keys. 


-ooutput 
The argument given is the name of an output file to use 
instead of the standard output. This file may be the same as 
one of the inputs. There may be optional blanks between -o 
and output. 


-ykmem 

The amount of main memory used by the sort has a large 
impact on its performance. Sorting a small file in a large 
amount of memory is a waste. If this option is omitted, sort 
begins using a system default memory size, and continues to 
use more space as needed. If this option is presented with a 
value, Kmem, sort will start using that number of kilobytes of 
memory, unless the administrative minimum or maximum is 
violated, in which case the corresponding extremum will be 
used. Thus, -yO is guaranteed to start with minimum memory. 
By convention, -y (with no argument) starts with maximum 
memory. 
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=-ZTe€CSZ 

The size of the longest line read is recorded in the sort phase 
so buffers can be allocated during the merge phase. If the 
sort phase is omitted via the -c or -m options, a popular sys- 
tem default size will be used. Lines longer than the buffer size 
will cause sort to terminate abnormally. Supplying the actual 
number of bytes in the longest line to be merged (or some 
larger value) will prevent abnormal termination. 


The following options override the default ordering rules. 


-d “Dictionary” order: only letters, digits and blanks (spaces and 
tabs) are significant in comparisons. 


-f | Fold lower case letters into upper case. 


-i Ignore characters outside the ASCII range 040-0176 in non- 
numeric comparisons. 


-M Compare as months. The first three non-blank characters of 
the field are folded to upper case and compared so that 
“TAN” < “FEB” <... < “DEC’’. Invalid fields compare low 
to “JAN”. The -M option implies the -b option (see below). 


-n An initial numeric string, consisting of optional blanks, an 
optional minus sign, and zero or more digits with optional 
decimal point, is sorted by arithmetic value. The -n option 
implies the -b option (see below). Note that the -b option is 
only effective when restricted sort key specifications are in 
effect. 


-r Reverse the sense of comparisons. 


When ordering options appear before restricted sort key 
specifications, the requested ordering rules are applied globally to 
all sort keys. When attached to a specific sort key (descnbed 
below), the specified ordering options override all global ordering 
options for that key. 


The notation +pos! -pos2 restricts a sort key to one beginning at 
posl and ending at pos2. The characters at positions pos] and pos2 
are included in the sort key (provided that pos2 does not precede 
pos1). A missing -pos2 means the end of the line. 
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Specifying pos1 and pos2 involves the notion of a field (a minimal 
sequence of characters followed by a field separator or a newline). 
By default, the first blank (space or tab) of a sequence of blanks 
acts as the field separator. All blanks in a sequence of blanks are 
considered to be part of the next field: for example, all blanks at 
the beginning of a line are considered to be part of the first field. 
The treatment of field separators can be altered using the options: 


-tx Use x as the field separator character; x is not considered to 
be part of a field (although it may be included in a sort key). 
Each occurrence of x is significant (e.g., xx delimits an empty 
field). 


-b_ Ignore leading blanks when determining the starting and end- 
ing positions of a restricted sort key. If the -b option is 
specified before the first +pos1 argument, it will be applied to 
all +posI arguments. Otherwise, the b flag may be attached 
independently to each +pos/ or -pos2 argument (see below). 


PosI and pos2 each have the form m.n optionally followed by one 
or more of the flags b, d, f, i, n, or r. A starting position specified 
by +m.n is interpreted to mean the n+1st character in the m+1st 
field. A missing .1 means .0, indicating the first character of the 
m+I\st field. If the b flag is in effect, n is counted from the first 
non-blank in the m+1st field; +m.Ob refers to the first non-blank 
character in the m+1st field. 


A last position specified by -m.n is interoreted to mean the nth 
character (including separators) after the last character of the mth 
field. A missing .1 means .0, indicating the last character of the 
mth field. If the b flag is in effect, n is counted from the last lead- 
ing blank in the m-+1st field; -m.1b refers to the first non-blank in 
the m+Ist field. 


When there are multiple sort keys, later keys are compared only 
after all earlier keys compare equal. Lines that otherwise compare 
equal are ordered with all bytes significant. 
Examples 
Sort the contents of infile with the second field as the sort key: 
sort +1 -2 infile 

Sort, in reverse order, the contents of infilel and infile2, placing the 
output in outfile and using the first character of the second field as 


the sort key: 


sort -r -o outfile +1.0 -1.2 infilel infile2 
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Sort, in reverse order, the contents of infilel and infile2 using the 
first non-blank character of the second field as the sort key: 


sort -r +1.0b -1.1b infilel infile2 


Print the password file (passwd(M)) sorted by the numeric user ID 
(the third colon-separated field): 


sort -t: +2n -3 /etc/passwd 
Print the lines of the already sorted file infile, suppressing all but 
the first occurrence of lines having the same third field (the options 
-um with just one input file make the choice of a unique represen- 


tative from a set of equal lines predictable): 


sort -um +2 -3 infile 


Files 


/usr/tmp/stm??? 


See Also 


comm(C), join(C), uniq(C) 


Diagnostics 


Comments and exits with non-zero status for various trouble condi- 
tions (e.g., when input lines are too long), and for disorders 
discovered under the -c option. When the last line of an input file 
is missing a newline character, sort appends one, prints a warning 
message, and continues. 
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Name 


split — Splits a file into pieces. 


Syntax 


split | —71 | [ file [ name ] ] 


Description 
Split reads file and writes it in n-line pieces (default 1000), as many 
as necessary, onto a set of output files. The name of the first out- 
put file is name with aa appended, and so on lexicographically. If 
no Output name is given, x is default. 
If no input file is given, or if a dash (—) is given instead, the stan- 
dard input file is used. 


See Also 


bfs(C), csplit(C) 
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Name 


stty — Sets the options for a terminal. 


Syntax 


stty [ -a | [ —g ] [ options ] 


Description 


Stty sets certain terminal I/O options for the device that is the 
current standard input. Without arguments, it reports the settings 
of certain options; with the —a option, it reports all of the option 
settings; with the —g option, it reports current settings in a form 
that can be used as an argument to another stty command. 
Detailed information about the modes listed in the first five groups 
below may be found in tty(M). Options in the last group are imple- 
mented using options in the previous groups. The options are 
selected from the following: 


Control Modes 


parenb (—parenb) 
Enables (disables) parity generation and detection. 


parodd (—parodd) 
Selects odd (even) parity. 


cs5 cs6 cs7 cs8 
Selects character size (see tty(M)). 


0 Hangs up phone line immediately. 
50 75 110 134 150 200 300 600 


1200 1800 2400 4800 9600 exta 
®Sets terminal baud rate to the number given, if possible. 


hupcl (—hupcl) 
Hangs up (does not hang up) phone connection on last close. 


hup (—hup) 
Same as hupcl (—hupcl). 


cstopb (—cstopb) 
Uses two(one) stop bits per character. 


cread (—cread) 
Enables (disables) the receiver. 
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clocal (—clocal) 
Assumes a line without (with) modem control. 


Input Modes 


ignbrk (—ignbrk) 
Ignores (does not ignore) break on input. 


brkint (—brkint) 
Signals (does not signal) INTR on break. 


ignpar (—ignpar) 
Ignores (does not ignore) parity errors. 


parmrk (—parmrk) 
Marks (does not mark) parity errors (see tty(M)). 


inpck (—inpck) 
Enables (disables) input parity checking. 


istrip (—istrip) 
Strips (does not strip) input characters to 7 bits. 


inler (—inlcr) 
Maps (does not map) NL to CR on input. 


igner (—igncr) 
Ignores (does not ignore) CR on input. 


icrnl (—icrnl) 
Maps (does not map) CR to NL on input. 


iucle (—iuclc) 
Maps (does not map) uppercase alphabetics to lowercase on 
input. 


ixon (—ixon) 
Enables (disables) START/STOP output control. Output is 
stopped by sending an ASCII DC3 and started by sending an 
ASCII DC1. 


ixany (—ixany) 
Allows any character (only DC1) to restart output. 

ixoff (—ixoff) 
Requests that the system send (not send) START/STOP charac- 
ters when the input queue is nearly empty/full. 
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Output Modes 


opost (—opost) 
Post-processes output (does not post-process output; ignores all 
other output modes). 


olcuc (—olcuc) 
Maps (does not map) lowercase alphabetics to uppercase on 
output. 


onlcr (—onlcr) 
Maps (does not map) NL to CR-NL on output. 


ocrnl (—ocrnl) 
Maps (does not map) CR to NL on output. 


onocr (—onocr) 
Does not (does) output CRs at column zero. 


onlret (—onlret) 
On the terminal NL performs (does not perform) the CR func- 
tion. 


ofill (—ofill) 
Uses fill characters (use timing) for delays. 


ofdel (—ofdel) 
— Fill characters are DELs (NULs). 


cr0 cri cr2 cr3 
Selects style of delay for carriage returns (see tty(M)). 


nlo nil 
Selects style of delay for linefeeds (see tty(M)). 


tab0 tabl tab2 tab3 
Selects style of delay for horizontal tabs (see tty(M)). 


bsO bs1 
Selects style of delay for backspaces (see tty(M)). 


ff0 ffl 
Selects style of delay for form feeds (see tty(M)). 


vt0 vtl 
Selects style of delay for vertical tabs (see tty(M)). 
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Local Modes 


isig (—isig) 
Enables (disables) the checking of characters against the special 
control characters INTR and QUIT. 


icanon (—icanon) 
Enables (disables) canonical input (ERASE and KILL process- 
ing). 


xcase (—xcase) 
Canonical (unprocessed) upper/lowercase presentation. 


echo (—echo) 
Echoes back (does not echo back) every character entered. 


echoe (—echoe) 
Echoes (does not echo) ERASE character as a _ backspace- 
space-backspace string. Note: this mode will erase the 
ERASEed character on many CRT terminals; however, it does 
not keep track of column position and, as a result, may be 
confusing on escaped characters, tabs, and backspaces. 


echok (—echok) 
Echoes (does not echo) NL after KILL character. 


Ifke (—Ifkc) 
The same as echok (—echok); obsolete. 


echonl (—echonl) 
Echoes (does not echo) NL. 


noflsh (—noflsh) 
Disables (enables) flush after INTR or QUIT. 


stwrap (—stwrap) 
Disables (enables) truncation of lines longer than 79 characters 
on a synchronous line. 


stflush (—stflush) 
Enables (disables) flush on a synchronous line after every 
write (S). 
stappl (—stappl) 
Uses application (line) mode on a synchronous line. 
Control Assignments 
control-character-C 


Sets control-character to C, where control-character is erase, 
kill, intr, quit, eof, eol, If C is preceded by a caret (“) (escaped 
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from the shell), the value used is the corresponding Ctrl charac- 
ter (e.g., ““D” is a Ctrl-D ); “*?” is interpreted as DEL and ‘““~” 
is interpreted as undefined. 


min 7, time i (0<i<127) 
When —icanon is not set, read requests are not satisfied until at 
least min characters have been received or the timeout value 
time has expired. See tty(C). 


line 7 
Sets the line discipline to i (0 <i < 127 ). There are currently 
no line disciplines implemented. 


Combination Modes 


evenp or parity 
Enables parenb and ¢s7. 


oddp 
Enables parenb, cs7, and parodd. 


— parity, ~evenp, or —oddp 
Disables parenb, and sets cs8. 


raw (—raw or cooked) 
Enables (disables) raw input and output (no ERASE, KILL, 
INTR, QUIT, EOT, or output post processing). 


ni(—nl) . 
Unsets (sets) icrnl, onler. In addition —nl unsets inler, igner, 
ocrnl, and onlret. 


Icase (—Icase) 
Sets (unsets) xcase, iuclc, and olcuc. 


LCASE (—LCASE) 
Same as Icase (—Icase). 


tabs (—tabs or tab3) 
Preserves (expands to spaces) tabs when printing. 


ek Resets ERASE and KILL characters back to normal Ctrl-H and 
Ctrl-U . 


sane 
Resets all modes to some reasonable values. Useful when a 
terminal’s settings have been hopelessly scrambled. 


term 


Sets all modes suitable for the terminal type term, where term is 
one of tty33, tty37, vt05, tn300, ti700, or tek. 
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See Also 


ioctl(S), tty(M) 


Notes 


Many combinations of options make no sense, but no checking is 
performed. 
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Name 


su — Makes the user a super-user or another user. 


Syntax 


su[— ][name[ arg... ] ] 


Description 


Su allows you to become another user without logging off. The 
default user name is root (i.e., super-user). 


To use su, the appropriate password must be supplied (unless you 
are already a super-user). If the password is correct, su will exe- 
cute a new Shell with the real and effective user ID set to that of the 
specified user. The new shell will be the optional program named 
in the shell field of the specified user’s password file (/bin/sh if 
none is specified (see sh(C)). To restore normal user ID privileges, 
press EOF (Ctrl-D) to the new shell. 


Any additional arguments given.on the command line are passed to 
the program invoked as the shell. When using programs like sh(C), 
an arg of the form —c string executes string via the shell and an arg 
of —r gives the user a restricted shell. 


The following statements are true only if the optional program 
named in the shell field of the specified user’s password file entry is 
like sh(C). If the first argument to su is a —, the environment is 
changed to what would be expected if the user actually logged in as 
the specified user. This is done by invoking the program used as 
the shell with an arg0 value whose first character is —, thus causing 
first the system’s profile (/etc/profile) and then the specified user’s 
profile (.profile in the new HOME directory) to be executed. Oth- 
erwise, the environment is passed along with the possible exception 
of $PATH, which is set to /bin:/etc:/usr/bin for root. Note that if 
the optional program used as the shell is /bin/sh, the user’s .profile 
can check arg0 for —sh or —su to determine if it was invoked by 
login(M) or su(C), respectively. If the user’s program is other than 
/bin/sh, then .profile is invoked with an arg0 of -program by both 
login(M) and su(C). 


All attempts to become another user using su are logged in the log 
file /usr/adm/sulog. 
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Examples 


To become user bin while retaining your previously exported 
environment, enter: 


su bin 


To become user bin but change the environment to what would be 
expected if bin had originally logged in, enter: 


su - bin 


To execute command with the temporary environment and permis- 
sions of user bin, enter: 


su - bin -c “command args” 


Files 
/etc/passwd The system password file 
/etc/profile The system profile 
$HOME/. profiie The user profile 
/usr/adm/sulog The log file 

See Also 


env(C), environ(M), login(M), passwd(M), profile(M), sh(C) 
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Name 


sum — Calculates checksum and counts blocks in a file. 


Syntax 


sum [ —r | file 


Description 
Sum calculates and prints a 16-bit checksum for the named file, 
and also prints the number of BSIZE blocks in the file. It is typi- 
cally used to look for bad spots, or to validate a file communicated 
over a transmission line. The option —r causes an alternate algo- 
rithm to be used in computing the checksum. 


See Also 


cmchk(C), machine(M), we(C) 


Diagnostics 
‘Read error” is indistinguishable from end-of-file on most devices; 
check the block count. 

Notes 


Refer to machine(M) or use the cmchk (C) utility to determine 
BSIZE for your system. 
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Name 


sync — Updates the super-block. 


Syntax 


sync 


Description 
Sync executes the sync system primitive. If the system is to be 
stopped, sync must be called to ensure file system integrity. Note 
that shutdown (C) automatically calls sync before shutting down the 
system. 


See Also 


sync(S) 
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Name 


sysadmin — Performs file system backups and restores files. 


Syntax 


/etc/sysadmin 


Description 

Sysadmin is a script for performing file system backups and for res- 
toring files from backup disks. It can do a daily incremental backup 
(level 9), ora periodic full backup (level Q). It can provide a listing 
of the files backed up and also has a facility to restore individual 
files from a backup. 

Sysadmin operates on XENIX format diskettes. The version pro- 
vided backs up the root file system. The script can be edited to 
operate on additional file systems if required. 


You must be the super-user to use this program. 


Files 


/tmp/backup.list 


See Also 


backup(C), restore(C), mkfs(C), dumpdir(C) 


August 26, 1985 Page 1 


TAIL (C) TAIL {(C) 


Name 


tail — Delivers the last part of a file. 


Syntax 


tail [ +{number][Ibc] | —f ] | [ file | 


Description 


Tail copies the named file to the standard output beginning at a 
designated place. If no file is named, the standard input is used. 


Copying begins at distance +mumber from the beginning,. or 
—number from the end of the input (if number is null, the value 10 
is assumed). Number is counted in units of lines, blocks, or char- 
acters, according to the appended option |, b, or c. When no units 
are specified, counting is by lines. 


With the —f (‘follow’) option, if the input file is not a pipe, the 
program will not terminate after the line of the input file has been 
copied, but will enter an endless loop, wherein it sleeps for a 
second and then attempts to read and copy further records from 
the input file. Thus it may be used to monitor the growth of a file 
that is being written by some other process. For example, the com- 
mand: 


tail -f file 
will print the last ten lines of file, followed by any lines that are 
appended to file between the time tail is initiated and killed. 
See Also 
dd(C) 


Notes 
Tails relative to the end of the file are kept in a buffer, and thus 


are limited in length. Unpredictable results can occur if character 
special files are “tailed”’. 
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Name 


tar — Archives files. 


Syntax 


tar [ key | [ files | 


Description 


Tar saves and restores files to and from an archive medium, which 
is typically a storage device such as floppy disk or tape, or a regular 
file. Its actions are controlled by the key argument. The key is a 
string of characters containing at most one function letter and pos- 
sibly one or more function modifiers. Valid function letters are c, 
t, x, u, e, and r. Other arguments to the command are files (or 
directory names) specifying which files are to be backed up or 
restored. In all cases, appearance of a directory name refers to the 
files and (recursively) subdirectories of that directory. 


The function portion of the key is specified by one of the following 
letters: 


r The named files are written to the end of the archive. The 
c function implies this function. 


X The named files are extracted from the archive. If a 
named file matches a directory whose contents had been 
written onto the archive, this directory is (recursively) 
extracted. The owner, modification time, and mode are 
restored (if possible). If no files argument is given, the 
entire contents of the archive are extracted. Note that if 
several files with the same name are on the archive, the 
last one overwrites all earlier ones. 


t The names of the specified files are listed each time that 
they occur on the archive. If no files argument is given, all 
the names on the archive are listed. 


u The named files are added to the archive if they are not 
already there, or if they have been modified since last writ- 
ten on that archive. 


c Creates a new archive; writing begins at the beginning of 


the archive, instead of after the last file. This command 
implies the r function. 
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The following characters may be used in addition to the letter that 
selects the desired function: 


0,...,7 This modifier selects the drive on which the archive is 
mounted. The default is found in the file /etc/default/tar. 


Vv Normally, tar does its work silently. The v (verbose) 
option causes it to display the name of each file it treats, 
preceded by the function letter. With the t function, v 
gives more information about the archive entries than just 
the name. 


Ww Causes tar to display the action to be taken, followed by 
the name of the file, and then wait for the user’s 
confirmation. If a word beginning with y is given, the 
action is performed. Any other input means “no’’. 


f Causes tar to use the next argument as the name of the 
archive instead of the default device’ listed in 
/etc/default/tar. If the name of the file is a dash (—), tar 
writes to the standard output or reads from the standard 
input, whichever is appropriate. Thus, tar can be used as 
the head or tail of a pipeline. Tar can also be used to 
move hierarchies with the command: 


cd fromdir; tar cf — . | (cd todir; tar xf —) 


b Causes tar to use the next argument as the blocking factor 
for archive records. The default is 1, the maximum is 20. 
This option should only be used with raw magnetic tape 
archives (see f above). The block size is determined 
automatically when reading tapes (key letters x and t). 


F Causes tar to use the next argument as the name of a file 
from which succeeding arguments are taken. A lone dash 
(—) signifies that arguments will be taken from the standard 
input. 


l Tells tar to display an error message if it cannot resolve all 
of the links to the files being backed up. If 1 is not 
specified, no error messages are displayed. 


m Tells tar to not restore the modification times. The 
modification time of the file is the time of extraction. 


k Causes tar to use the next argument as the size of an 
archive volume in kilobytes. The minimum value allowed 
is 250. This option is useful when the archive is not 
intended for a magnetic tape device, but for some fixed 
size device, such as floppy disk (See f above). Very large 
files are split into “‘extents” across volumes. When restor- 
ing from a multivolume archive, tar only prompts for a 
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new volume if a split file has been partially restored. To 
override the value of k in the default file, specify k as 0 on 
the command line. 


e Prevents files from being split across volumes (tapes or 
floppy disks). If there is not enough room on the present 
volume for a given file, tar prompts for a new volume. 
This is only valid when the k option is also specified on 
the command line. 


n Indicates the archive device is not a magnetic tape. The k 
option implies this. Listing and extracting the contents of 
an archive are sped because tar can seek over files it 
wishes to skip. Sizes are printed in kilobytes instead of 
tape blocks. 


p Indicates that files are extracted using their original permis- 
sions. It is possibie that a non-super-user may be unable 
to extract files because of the permissions associated with 
the files or directories being extracted. 


A Suppresses absolute filenames during extraction. Any 
leading ‘“/”’characters are removed from filenames. Argu- 
ments given should match the relative (rather than the 
absolute) pathnames of the files extracted. 


Tar reads /etc/default/tar to obtain default values for the device, 
blocking factor and volume size. If no numeric key is specified on 
the command, tar looks for a line in the default file beginning with 
the string archiveO=. Following this pattern are 3 blank separated 
strings indicating the values for the device, blocking factor, and 
volume size, in that order. A volume size of ‘Q’ indicates infinite 
volume length, (the previous default value of volume) and is suit- 
able for magnetic tape media. An example /etc/default/tar line 
follows: 


archiveQ=/dev/fd0 1 400 


Any default value may be overridden on the command line. The 
numeric keys (0-7) select the line from the default value beginning 
with archive#=, where # is the numeric key. When the f key letter 
is specified on the command line, the entry “archivef=" is used. In 
this case, the default file entry must still contain 3 strings, but the 
first entry (specifying the device) is not significant. The default file 
/etc/default/tar must exist. 
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Examples 


If the name of a floppy disk device is /dev/fd1, then a tar format 
file can be created on this device by entering: 

assign /dev/fd 

tar cvfk /dev/fd1 360 files 


where files are the names of files you want archived and 360 is the 
capacity of the floppy disk in kilobytes. Note that arguments to key 
letters are given in the same order as the key letters themselves, 
thus the fk key letters have corresponding arguments /dev/fd1 and 
360. Note that if a file is a directory, the contents of the directory 
are recursively archived. To display a listing of the archive, enter: 


tar tvf /dev/fdl 


At some later time you will likely want to extract the files from the 
archive floppy. You can do this by entering: 


tar xvf /dev/fdl 


The above command extracts all files from the archive, using the 
exact same pathnames as used when the archive was created. 
Because of this behavior, it is normally best to save archive files 
with relative pathnames rather than absolute ones, since directory 
permissions may not let you read the files into the absolute direc- 
tories specified. (See the A flag under Options.) 


In the above examples, the v verbose option is used simply to 
confirm the reading or writing of archive files on the screen. Also, 
a normal file could be substituted for the floppy device /dev/fd1 
shown in the examples. 


Files 
/etc/default/tar Default devices, blocking and 
volume sizes 
/tmp/tar* 
Diagnostics 


Displays an error message about bad key characters and archive 
read/write errors. 


Displays an error message if not enough memory is available to 
hold the link tables. 


Does not function without a valid /etc/default/tar. 
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Notes 
There is no way to ask for the mth occurrence of a file. 
The u option can be slow. 


The b option should not be used with archives that are going to be 
updated. If the archive is on a disk file, the b option should not be 
used at all, because updating an archive stored on disk can destroy 
it. In order to update (r or u option) a tar archive, do not use raw 
magnetic tape and do not use the b option. This applies both when 
updating and when the archive was first created. 


The limit on filename length is 100 characters. 

When archiving a directory that contains subdirectones, tar will 
only access those subdirectories that are within 17 levels of nesting. 
Subdirectories at higher levels will be ignored after tar displays an 
error message. 

Systems with a 1K-byte file system cannot specify raw disk devices 
unless the b option is used to specify an even number of blocks. 
This means that one cannot update a raw-mode disk partition. 

Do not enter: 


tar xfF - — 


This would imply taking two things from the standard input at the 
same time. | 


Use error-free floppy disks for best results with far. 
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Name 


tee — Creates a tee in a pipe. 


Syntax 


tee [| —i|[—a][—u ][ file ] ... 


Description 
Tee transcribes the standard input to the standard output and 
makes copies in the files. The —i option ignores interrupts; the —a 
option causes the output to be appended to the files rather than 
overwriting them. The —u option causes the output to be unbuf- 
fered. 


Examples 


The following example illustrates the creation of temporary files at 
each stage in a pipeline: 


grep ABC | tee ABC. grep | sort | tee ABC.sort | more 
This example shows how to tee output to the terminal screen: 


grep ABC | tee /dev/tty | sort | uniq >final.file 
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Name 


TEST (C) 


test — Tests conditions. 


Syntax 
test expr 


[ expr ] 


Description 


Test evaluates the expression expr , and if its value is true, returns a 
zero (true) exit status; otherwise, test returns a nonzero exit status if 
there are no arguments. The following primitives are used to con- 


struct expr: 


—r file 
—w file 
—x file 
—f file 
—d file 
—c file 
—b file 
—u file 
—g file 
—k file 
—s file 
—t | fildes | 
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True if file exists and is readable. 

True if file exists and is writable. 

True if file exists and is executable. 

True if file exists and is a regular file. 

True if file exists and is a directory. 

True if file exists and is a character special file. 

True if file exists and is a block special file. 

True if file exists and its set-user-ID bit 1s set. 

True if file exists and its set-group-ID bit is set. 

True if file exists and its sticky bit is set. 

True if file exists and has a size greater than zero. 

True if the open file whose file descriptor number is 
fildes (1 by default) is associated with a terminal dev- 
ice. 

True if the length of string s/ is zero. 


True if the length of the string sZ is nonzero. 


True if strings s27 and s2 are identical. 


Page 1 


TEST (C) | TEST (C) 
sl {= s2 True if strings s2 and s2 are not identical. 
sl True if s7 is not the null string. 
| 8 J 
nl —eqn2_ True if the integers nJ and n2 are algebraically equal. 
Any of the comparisons —ne, —gt, —ge, —It, and —le 
may be used in place of —eq. 
These primaries may be combined with the following operators: 
: Unary negation operator 
—a Binary and operator 
—O Binary or operator (—a has higher precedence than 
—o) 
( expr ) Parentheses for grouping 
Notice that all the operators and flags are separate arguments to 
test. Notice also, that parentheses are meaningful to the shell and, 
therefore, must be escaped. 
See Also 
find(C), sh(C) 
wo, 
Warning 
In the second form of the command (i.e., the one that uses [], 
rather than the word fest), the square brackets must be delimited by 
blanks. 
ws 
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Name 


touch — Updates access and modification times of a file. 


Syntax 


touch [ —amce | [ mmddhhmmyy] ] files 


Description 


Touch causes the access and modification times of each argument 
to be updated. If no time is specified (see date(C)) the current 
time is used. The first mm refers to the month, dd refers to the 
day, hh refers to the hour, the second mm refers to the minute, 
and yy refers to the year. The —a and —m options cause touch to 
update only the access or modification times respectively (default is 
—-am). The —c option silently prevents touch from creating the file 
if it did not previously exist. 


The return code from touch is the number of files for which the 
times could not be successfully modified (including files that did 
not exist and were not created). 


See Also 


date(C), utime(S) 
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Name 


tr — Translates characters. 


Syntax 


tr [ —cds | [ string [ string2 ] ] 


Description 


Tr copies the standard input to the standard output with substitu- 
tion or deletion of selected characters. Input characters found in 
string] are mapped into the corresponding characters of string2. 
Any combination of the options —cds may be used: 


“<€ Complements the set of characters in string] with respect 
to the universe of characters whose ASCII codes are 001 
through 377 octal 


—d Deletes all input characters in string] 


—sS Squeezes all strings of repeated output characters that are 
in String2 to single characters 


The following abbreviation conventions may be used to introduce 
ranges of characters or repeated characters into the strings: 


[a—z] Stands for the string of characters whose ASCII codes run 
from character a to character z, inclusive. 


[a*n] Stands for n repetitions of a. If the first digit of n is 0, n 
is considered octal; otherwise, n is taken to be decimal. 
A zero or missing 7 is taken to be huge; this facility is use- 
ful for padding string2. 


The escape character \ may be used as in the shell to remove spe- 
cial meaning from any character in a string. In addition, \ followed 
by 1, 2, or 3 octal digits, stands for the character whose ASCII 
code is given by those digits. 
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The following example creates a list of all the words in filel, one 
per line in file2, where a word is taken to be a maximal string of 
alphabetics. The strings are quoted to protect the special charac- 
ters from interpretation by the shell; 012 is the ASCII code for new- 
line: 
tr -cs "[A-Z][a—z]" "[\012*]" <filel >file2 

See Also 
ed(C), sh(C), ascii(M) 

Notes 


Won’t handle ASCII NUL in string] or string2; always deletes NUL 
from input. 
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Name 


true — Returns with a zero exit value. 


Syntax 


true 


Description 


True does nothing except return with a zero exit value. False(C), 
true’s counterpart, does nothing except return with a nonzero exit 
value. True is typically used in shell procedures such as: 


while true 
do 

command 
done 


See Also 


sh(C), false (C) 


Diagnostics 


True has exit status zero. 
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Name 


tset — Sets terminal modes. 


Syntax 


tset [ — ][ —hrsulQS ] [ -e{c] ] [ -E{c] ] [ —k{c] ] 
[ —m [ident] [test baudrate |:type | [ type | 


Description 


Tset causes terminal dependent processing such as setting erase and 
kill characters, setting or resetting delays, and the like. It is driven 
by the /etc/ttytype and /etc/termcap files. 


The type of terminal is specified by the type argument. The type 
may be any type given in /etc/termcap. If type is not specified, the 
terminal type is the value of the environment variable TERM, unless 
the —h flag is set or any —m argument is given. In this case, the 
type is read from /etc/ttytype (the port name to terminal type 
database). The port name is determined by a ttyname(S) call on 
the diagnostic output. If the port is not found in /etc/ttytype the 
terminal type is set to unknown. 


Ports for which the terminal type is indeterminate are identified in 
/etc/ttytype as dialup, plugboard, etc. The user can specify how 
these identifiers should map to an actual terminal type. The 
mapping flag, —m, is followed by the appropriate identifier (a four- 
character or longer substring is adequate), an optional test for baud 
rate, and the terminal type to be used if the mapping conditions are 
satisfied. li more than one mapping is specified, the first correct 
mapping prevails. A missing identifier matches all identifiers. 
Baud rates are specified as with stty(C), and are compared with the 
speed of the diagnostic output. The test may be any combination 
of: >, =, <, @, and !. (Note: @ is a synonym for = and ! inverts 
the sense of the test. Remember that escape characters are 
meaningful to the shell.) 


If the type as determined above begins with a question mark, the 
user is asked if he really wants that type. A null response means to 
use that type; otherwise, another type can be entered which will be 
used instead. (The question mark must be escaped to prevent 
filename expansion by the shell.) 


Tset is most useful when included in the .login (for csh(C)) or 
profile (for sh(C)) file executed automatically at login, with —m 
mapping used to specify the terminal type you most frequently dial 
in on. 
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Options 


-e This flag sets the erase character to be the named character c on 
all terminals, so to override this option, one can say ~e#. The 
default for c is the backspace character on the terminal, usually 
Ctrl-H . 


=i 
This flag is identical to —e except that it only operates on 
terminals that can backspace. 


-k This option sets the kill character to the named character, c, 
with c defaulting to Ctrl-U. No kill processing is done if —k is 
not specified. In all of these flags, ““X”? where X is any 
character is equivalent to Ctrl-X . 


— This option prints the terminal type on the standard output; this 
can be used to get the terminal type by entering: 


set termtype = ‘tset - 


If no other options are given, ftset operates in “fast mode” and 
only outputs the terminal type, bypassing all other processing. 


-s This option outputs “setenv” commands (if your default shell is 
csh(C) or ‘“‘export” and assignment commands (if your default 
shell is sh(C)); 


For the —s option with the Bourne shell, enter: 


tset -s ... > /tmp/tset$$ 
/tmp/tset$$ 
rm /tmp/tset$$ 


-S This option only outputs the strings to be placed in the 
environment variables. 


If you are using csh, enter: 
set noglob 
set term=(‘tset -S ....‘) 
setenv TERM $term[1] 
setenv TERMCAP "“$term[2]" 
unset term 
unset noglob 


-r This option displays the terminal type on the diagnostic output. 


ae 
This option suppresses displaying the “Erase set to” and “Kill 
set to”? messages. 
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-I This option suppresses outputing the terminal initialization 
strings. 
—m 
This option is the mapping flag. It is used to specify the termi-— 
nal type you most frequently use. It is followed by the appropri-— 
ate identifier for your terminal, listed in /ete/ttytype . When you 


log on the system, it sets the terminal type to ident unless you 
specify otherwise. 


Examples 

tset gt42 
Sets the terminal type to gt42. 

tset —mdialup\>300:adm3a —mdialup:dw2 —Qr -e# 
If the entry in /etc/ttytype corresponding to the login port is 
“dialup”, and the port speed is greater than 300 baud, set the 
terminal type to adm3a. If the /etc/ttytype entry is “dialup” and 
the port speed is less than or equal to 300 baud, set the terminal 
type to dw2. Set the erase character to “#’’, and display the ter— 
minal type (but not the erase character) on standard error. 


tset —m dial:ti733 —m plug:\?hp2621 —m unknown:\? -e -k U 


If the /etc/ttytype entry begins with ‘“‘dial’’, the terminal type 
becomes ti733. If the entry begins with “plug’’, tset prompts 
with: 

TERM = (hp2621) 


Enter the correct terminal type if it is different than that shown. 
If the entry is “unknown ’’, tset prompts with: 


TERM = (unknown) 


In any case erase is set to the terminal’s backspace character, 
and the terminal type is displayed on standard error. 


Files 
/etc/ttytype Port name to terminal type map database 


/etc/termcap Terminal capability database 
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See Also 


tty(M), termcap(M), stty(C) 


Credit 


This utility was developed at the University of California at 
Berkeley and is used with permission. 
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Name 


tty — Gets the terminal’s name. 


Syntax 


tty [ —s | 


Description 
The tty command prints the pathname of the user’s terminal on the 
standard output. The —s option inhibits printing, allowing you to 
test just the exit code. 


Exit Codes 


0 if the standard input is a terminal, 1 otherwise. 
Diagnostics 


not a tty If the standard input is not a terminal and —s is not 
specified 
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Name 


umask — Sets file-creation mode mask. 


Syntax 


umask [ 000 | 


Description 


The user file-creation mode mask is set to ooo. The three octal 
digits refer to read/write/execute permissions for owner, group, and 
others, respectively. Only the low-order 9 bits of cmask and the 
file mode creation mask are used. The value of each specified digit 
is “subtracted” from the corresponding “digit” specified by the 
system for tie creation of any file (see umask(S) or creat(S)). This 
is actually a binary masking operation, and thus the name “‘umask”’. 
In general, binary ones remove a given permission, and zeros have 
no effect at all. For example, umask 022 removes group and 
Others write permission (files normally created with mode 777 
become mode 755 ; files created with mode 666 become mode 644). 


If ooo is omitted, the current value of the mask is printed. 
Umask is recognized and executed by the shell. By default, login 
Shells have a umask of 022. 

See Also 


chmod(C); sh(C), chmod(S), creat(S), umask(S) 
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Name 


umount — Dismounts a file structure. 


Syntax 


/etc/umount special-device 


Description 
Umount announces to the system that the removable file structure 
previously mounted on device special-device is to be removed. Any 
pending I/O for the file system is completed, and the file structure 
is flagged clean. For a detailed explanation of the mounting pro- 
cess, see mount (C). 


Files 


/etc/mnttab Mount table 


See Also 


mount(C), mount(S), mnttab(F) 


Diagnostics 


device busy An executing process is using a file on the named 
file system 
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uname — Prints the name of the current XENIX system. 


Syntax 


uname [ -snrmvydupa | 


Description 


Uname prints the current system name of the XENIX system on the 
standard output file. It is primarily used to determine which system 


you a 
unam 


=S 


-n 


-r 


-m 


-V 
-d 
-u 
-p 


-a 


See Also 


unam 


re using. The options cause selected information returned by 
e(S) to be printed: 


Prints the system name (default). 


Prints the nodename (the nodename may be a name that the 
system is known by to a communications network). 


Prints the operating system release. 


Manufacturer prints original supplier (number) of XENIX sys- 
tem. 


Prints the operating system version. 

Distributor prints OEM (number) for the system. 
Prints user serial number. 

Prints processor of the machine. 


Prints all the above information. 


e(S) 
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Name 


uniq — Reports repeated lines in a file. 


Syntax 


unig [| —ude [ +n | [ —n ] ] [ input [ output ] ] 


Description 


Uniq reads the input file and compares adjacent lines. In the nor- 
mal case, the second and succeeding copies of repeated lines are 
removed; the remainder is written on the output file. Input and 
output should always be different. Note that repeated lines must be 
adjacent in order to be found; see sort(C). If the —u flag is used, 
just the lines that are not repeated in the original file are output. 
The —d option specifies that one copy of just the repeated lines is 
to be written. The normal mode output is the union of the —u and 
—d mode outputs. 


The —c option supersedes —u and —d and generates an output 
report in default style but with each line preceded by a count of the 
number of times it occurred. 


The 1 arguments specify skipping an initial portion of each line in 
the comparison: 


—_7 The first nm fields together with any blanks before each are 
ignored. A field is defined as a string of nonspace, nontab 
characters separated by tabs and spaces from its neighbors. 


+71 The first m characters are ignored. Fields are skipped 
before characters. 


See Also 


comm(C), sort(C) 
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Name 


units — Converts units. 


Syntax 


units 


Description 


Units converts quantities expressed in various standard scales to 
their equivalents in other scales. It works interactively in this 
fashion: 


You have: inch 

You want: cm 
* 2.540000e+00 
/ 3.937008e-01 


A quantity is specified as a multiplicative combination of units 
optionally preceded by a numeric multiplier. Powers are indicated 
by suffixed positive integers, division is shown by the usual sign: 


You have: 15 Ibs force/in2 
You want: atm 

* 1.020689e+00 

/ 9.797299e-01 


Units only does multiplicative scale changes; thus it can convert 
Kelvin to Rankine, but not Centigrade to Fahrenheit. Most fami- 
liar units, abbreviations, and metric prefixes are recognized, as well 
as the following: 


pi Ratio of circumference to diameter 
c Speed of light 

e Charge on an electron 

g Acceleration of gravity 


force Same as g 


mole 
Avogadro’s number 


water 
Pressure head per unit height of water 
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au Astronomical unit 

Pound is not recognized as a unit of mass; Ib is. Compound names 
are run together, (e.g. lightyear). British units that differ from 
their US counterparts are prefixed with “br”. For a complete list 
of units, enter: 


cat /usr/lib/unittab 


Files 


/usr/lib/unittab 
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Name 


uuclean — Clean-up the uucp spool directory. 


Syntax 


uuclean [ options }... 


Description 
Uuclean scans the spool directory for files with the specified prefix 
and deletes all those which are older than the specified number of 
hours. 


The following options are available: 


—ddirectory 
Clean directory instead of the spool directory. 


—ppre Scan for files with pre as the file prefix. Up to 10 —p 
arguments may be specified. A —p without any pre 
following will cause all files older than the specified time to 
be deleted. 


—ntime Files whose age is more than time hours are deleted if the 
prefix test is satisfied. (Default time is 72 hours.) 


—m Send mail to the owner of the file when it is deleted. 


This program will typically be started by cron(C). 


Files 
/usr/lib/uucp directory with commands used by uuclean 
internally 
/usr/spool/uucp __ spool directory 


See Also 


uucp(C), uux(C). 
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Name 


uucp, uulog, uuname - Copies files from XENIX to XENIX. 


Syntax 
uucp [ option ]... source-file .... destination-file 
uulog [ option ] ... 


uuname [ -1 | [ -v | 


Description 


Uucp copies files named by the source-file arguments to the 
destination-file argument. A filename may be a pathname on your 
machine, or may have the form: 


system-name!pathname 


where “system-name” is taken from a list of system names which 
uucp knows about. Shell metacharacters ?*[] appearing in path- 
name will be expanded on the appropriate system. 


Pathnames may be a a full pathname, or a pathname preceded by 
“user where user is a user ID on the specified system and is replaced 
by that user’s login directory. Anything else is prefixed by the 
current directory. 


If the result is an erroneous pathname for the remote system, the 
copy will fail. If the destination file is a directory, the last part of 
the source filename is used. 


Uucp preserves execute permissions across the transmission and 
gives 0666 read and write permissions (see chmod (S)). 


The following options are interpreted by uucp: 
-d Makes all necessary directories for the file copy. 


-C Uses the source file when copying out rather than 
copying the file to the spool directory. 


-m Sends mail to you when the copy is complete. 
Uulog maintains a summary log of uucp and uux(C) transactions in 
the file /usr/spool/uucp/LOGFILE by gathering information from 


partial log files named /usr/spool/uucp/LOG.*.?. Uulog removes 
the partial log files. 
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The options cause uulog to display log information: 


-SSYS 
Displays information about work involving system sys. 


-uuser 
Displays information about work done for the specified user. 


Uuname displays the uucp names of known systems. The -l option 
returns the local system name. The -v option displays additional 
information about each system. A description is displayed for each 
system that has a line of information in /usr/lib/uucp/ADMIN. 
The format of ADMIN is: 


sysname tab description tab 


Files 
/usr/spool/uucp Spool directory 


/usr/spool/uucppublic Public directory for receiving and 
sending (PUBDIR) 


/usr/lib/uucp/* Other data and program files 


See Also 
uux(C), mail(C), uuinstall(C), uuto(C) 


Notes 


For security reasons, all files received by uucp should be owned by 
uucp. 


The -m option will only work sending files or receiving a single file. 
Receiving multiple files specified by special shell characters ?*[] will 
not activate the -m option. 


This version of uucp is based on a version 7 implementation. 


Warning 
For security reasons, file access should be, and usually is, severely 


restricted. You probably will not be able to copy or manipulate 
arbitrary files, or execute many commands, on a remote machine. 
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Similarly, you may not be able to send files to arbitrary, remote 
pathnames. As distributed, the remotely accessible files are in 
/usr/spool/uucppublic. 
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Name 


uuinstall — Administer UUCP control files. 


Syntax 


/etc/uuinstall [-r] 


Description 


The uuinstall program is used to manage the content of the control 
files used by the wucp communications system. It allows the user to 
change the contents of these files without using a text editor. The 
user need not know the detailed format of each of the control files, 
although he must be familiar with the function of the various fields 
within the files. These details are explained in the XENIX User’s 
Guide . 


The uuinstall program can only be executed by the super-user. 
When invoked with the optional -r flag, uuinstall will not allow any 
of the files to be modified whether or not the user has made 
changes to the files. 


If uuinstall finds any of the required uucp control files missing from 
the system, it will create them with the correct access permissions 
and ownership. 


Files 
/etc/systemid 
/usr/lib/uucp/USERFILE 
/usr/lib/uucp/L.sys 
/usr/lib/uucp/L-devices 
/usr/lib/uucp/L-dialcodes 
See Also 


mkuser(C), 
XENIX User’s Guide 
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Name 


uustat — Uucp status inquiry and job control. 


Syntax 


uustat [ option ]... 


Description 


Uustat will display the status of, or cancel, previously specified 
uucp commands, or provide general status on uucp connections to 
other systems. The following options are recognized: 


—mmch Report the status of accessibility of machine mch. If 
mch is specified as all, the status of all machines known 
to the local uucp are provided. 

—kjobn Kill the uucp request whose job number is jobn. The 
killed uucp request must belong to the person issuing the 
uustat command unless he is the super-user. 

—chour Remove the status entries which are older than hour 
hours. This administrative option can only be initiated 
by the user uucp or the super-user. 

—uuser Report the status of all uucp requests issued by user. 

—SSYS Report the status of all uucp requests which communi- 
cate with remote system sys. 

—ohour Report the status of all uucp requests which are older 
than Aour hours. 

—yhour Report the status of all uucp requests which are younger 
than hour hours. 


—jall Report the status of all the uucp requests. 

—V Report the uucp status verbosely. If this option is not 
specified, a status code is displayed with each uucp 
request. 


When no options are given, uustat outputs the status of all uucp 
requests issued by the current user. Note that only one of the 
options —j, ~m, —k, or —c may be specified at a time. 
For example, the command: 

uustat -uhdc -smhtsa -y72 -v 
prints the verbose status of all wucp requests that were issued by 
user hdc to communicate with system mhtsa within the last 72 


hours. The job request status format is: 


job-number user remote-system command-time status-time 
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where the status may be either an octal number or a verbose 
description. The octal code corresponds to the following descrip- 


tion: 

OCTAL STATUS 

00001 the copy failed, but the reason cannot be determined 
00002 permission to access local file is denied 
00004 permission to access remote file is denied 
00010 bad uucp command is generated 

00020 remote system cannot create temporary file 
00040 cannot copy to remote directory 

00100 cannot copy to local directory 

00200 local system cannot create temporary file 
00400 cannot execute uucp 

01000 copy succeeded 

02000 copy finished, job deleted 

04000 job is queued 


The machine accessibility status format is: 


system-name time status 


where time is the latest status time and status is a self-explanatory 
description of the machine status. 


Files 


/usr/spool/uucp spool directory 
/usr/lib/uucp/L_stat 

system status file 
/usr/lib/uucp/R_stat 


request status file 


See Also 
uucp(C). 
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Name 


uusub — Monitor uucp network. 


Syntax 


uusub [ options |] 


Description 


Uusub defines a uucp subnetwork and monitors the connection and 
traffic among the members of the subnetwork. The following 
options are available: 


—asys Add sys to the subnetwork. 
—dsys Delete sys from the subnetwork. 


=| Report the statistics on connections. 
—r Report the statistics on traffic amount. 
—f Flush the connection statistics. 


—uhr Gather the traffic statistics over the past Ar hours. 

—csys Exercise the connection to the system sys. If sys is 
specified as all, then exercise the connection to all the sys- 
tems in the subnetwork. 


The connections report format is: 
sys #call #ok time #dev #login #nack #other 


where sys is the remote system name, #call is the number of times 
the local system tries to call sys since the last flush was done, #ok 
is the number of successful connections, time is the the latest suc- 
cessful connect time, #dev is the number of unsuccessful connec- 
tions because of no available device (e.g. ACU), #login is the 
number of unsuccessful connections because of login failure, 
#tnack is the number of unsuccessful connections because of no 
response (e.g., line busy, system down), and #other is the number 
of unsuccessful connections because of other reasons. 


The traffic statistics format is: 

sfile sbyte rfile rbyte 
where sfile is the number of files sent and sbyte is the number of 
bytes sent over the period of time indicated in the latest uusub 


command with the —uAr option. Similarly, rfile and rbyte are the 
numbers of files and bytes received. 
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The command: 
uusub —c all —u 24 


is typically started by cron(C) once a day. 


Files 
/usr/spool/uucp/SYSLOG 
system log file 
/usr/lib/uucp/L_sub connection statistics 
/usr/lib/uucp/R_sub _ traffic statistics 
See Also 


uucp(C), uustat(C). 


August 26, 1985 Page 2 


UUTO (C) UUTO (C) 


Name 


uuto, uupick — Public XENIX-to-XENIX file copy. 


Syntax 
uuto [ options | source-files destination 
uupick [| —s system ] 

Description 
Uuto sends source-files to destination. Uuto uses the uucp(CP) 
facility to send files, while it allows the local system to control the 
file access. A source-file name is a path name on your machine. 
Destination has the following format: 

system!user 

where system is taken from a list of system names that uucp knows 
about (see uuname(CP)). Logname is the login name of someone 


on the specified system. 


Two options are available: 


=p Copy the source file into the spool directory before 
transmission. 
—m Send mail to the sender when the copy is complete. 


The files (or sub-trees if directories are specified) are sent to 
PUBDIR on system, where PUBDIR is a public directory defined in 
the uucp source. Specifically the files are sent to 
PUBDIR/receive/user/mysystem/files. 
The destined recipient is notified by mail(C) of the arrival of files. 
Uupick accepts or rejects the files transmitted to the user. 
Specifically, uupick searches PUBDIR for files destined for the user. 
For each entry (file or directory) found, the following message is 
printed on the standard output: 
from system: [file file-name | [dir dirname] ? 


Uupick then reads a line from the standard input to determine the 
disposition of the file: 


<new-line> Go on to next entry. 


August 26, 1985 Page 1 


UUTO (C) UUTO (C) 


d Delete the entry. 


m [ dir | Move the entry to named directory dir (current 
directory is default). 


a[ dir | Same as m except moving all the files sent from 
system. 

) Print the content of the file. 

q Stop. 


EOT (control-d) Same as q. 
!command Escape to the shell to do command. 
. Print a command summary. 


Uupick invoked with the —ssystem option will only search the 
PUBDIR for files sent from system. 


Files 


PUBDIR /usr/spool/uucppublic public directory 


See Also 


mail(C), uuclean(C), uucp(C), uuname(C), uustat(C), uux(C). 
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Name 


uux — Executes command on remote XENIX. 


Syntax 


uux [ — ] command-string 


Description 
Uux gathers 0 or more files from various systems, executes com- 
mands on a specified system, and sends the standard output to a 
file on a specified system. 
The command-string is made up of one or more arguments that 
look like a shell command line, except that the command and 
filenames may be prefixed by system-name!. A null system-name is 
interpreted as the local system. 
Filenames may be (1) a full pathname; (2) a pathname preceded by 
“Xxx; where xxx is a user ID on the specified system and is replaced 
by that user’s login directory; or (3) anything else prefixed by the 
current directory. 


The “—” option causes the standard input to the uux command to 
be the standard input to the command-sstring. 


For example, the command: 
uux "!diff usg!/usr/dan/f1 pwba!/a4/dan/f1 > !fi.diff" 


will get the fl files from the usg and pwba machines, execute a diff 
command and put the results in fl.diff in the local directory. 


Any special shell characters such as <>;| should be quoted either 
by quoting the entire command-string, or quoting the special char- 
acters as individual arguments. 

Files 
/usr/uucp/spool Spool directory 


/usr/uucp/* Other data and programs 


See Also 


uucp(C) 
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Warning 
An installation may, and for security reasons generally will, limit 
the list of commands executable on behalf of an incoming request 
from uux. Typically, a restricted site will permit little other than the 
receipt of mail via uux. 

Notes 
Only the first command of a shell pipeline may have a system- 
name!. All other commands are executed on the system of the first 
command. 
The shell metacharacter * will probably not perform as expected. 


The shell tokens << and >> are not implemented. 


There is no notification of denial of execution on the remote 
machine. 
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vi — Invokes a screen-oriented display editor. 


Syntax 
vi [| -option... | [ command ] [ filename ] 


view [ —option ... ] [ command ... ] [ filename ... ] 


Description 


Vi offers a powerful set of text editing operations based on a set of 
mnemonic commands. Most commands are single keystrokes that 
perform simple editing functions. Vi displays a full screen ‘“‘win- 
dow” into the file you are editing. The contents of this window can 
be changed quickly and easily within vi. While editing, visual feed- 
back is provided (the name vi itself is short for ‘“‘visual’’ ). 


The view command is the same as wi except that the read-only 
option (—R) is set automatically. The file cannot be changed with 
view. 


Vi and the line editor ex are one and the same editor: the names vi 
and ex identify a particular user interface rather than any underlying 
functional difference. The differences in user interface, however, 
are quite striking. Ex is a powerful line-oriented editor, similar to 
the editor ed. However, in both ex and ed, visual updating of the 
terminal screen is limited, and commands are entered on a com- 
mand line. Vi, on the other hand, is a screen-oriented editor 
designed so that what you see on the screen corresponds exactly 
and immediately to the contents of the file you are editing. In the 
following discussion, vi commands and options are printed in bold- 
face type. 


Options available on the vi command line include: 


—t Equivalent to an initial tag command; edits the file con- 
taining the tag and positions the editor at its definition. 


—|r Used in recovering after an editor or system crash, 
retrieving the last saved version of the named file. If no 
file is specified, this option prints a list of saved files. 


—| Specific to editing LISP, this option sets the showmatch 
and lisp options. 


—wi Sets the default window size to n. Useful on dialups to 
start in small windows. 
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—-R Sets a read-only option so that files can be viewed but 
not edited. 


The Editing Buffer 


Vi performs no editing operations on the file that you name during 
invocation. Instead, it works on a copy of the file in an The editor 
remembers the name of the file specified at invocation, so that it 
can later copy the editing buffer back to the named file. The con- 
tents of the named file are not affected until the changes are copied 
back to the original file. This allows editing of the buffer without 
immediately destroying the contents of the original file. 


When you invoke vi with a single filename argument, the named file 
is copied to a temporary editing buffer. When the file is written 
out, the temporary file is written back to the named file. 


Modes of Operation 


Within vi there are three distinct modes, of operation: 


Command Mode Within command mode, signals from the 
keyboard are interpreted as editing com- 
mands. 

Insert Mode Insert mode can be entered by typing any 


of the vi insert, append, open, substitute, 
change, or replace commands. Once in 
insert mode, letters typed at the key- 
board are inserted into the editing buffer. 


Ex Escape Mode The wi and ex editors are one and the 
same editor differing mainly in their user 
interface. In vi , commands are usually 
single keystrokes. In ex, commands are 
lines of text terminated by a RETURN. 
Vi has a special ‘“‘escape’’ command that 
gives access to many of these line- 
oriented ex commands. To use the ex 
escape mode, type a colon (:). The 
colon is echoed on the status line as a 
prompt for the ex command. An execut- 
ing command can be aborted by pressing 
INTERRUPT. Most file manipulation 
commands are executed in ex escape 
mode (for example, the commands to 
read in a file and to write out the editing 
buffer to a file). 
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Special Keys 


There are several special keys in vi. The following keys are used to 
edit, delimit, or abort commands and command lines. 


ESC 


RETURN 


Used to return to vi command mode, cancel partially 
formed commands. 


Terminates ex commands when in ex escape mode. 
Also used to start a newline when in insert mode. 


INTERRUPT 


Often the same as the DEL or RUBOUT key on many 
terminals. Generates an interrupt, telling the editor to 
stop what it is doing. Used to abort any command 
that is executing. 


Used to specify a string to be searched for. The slash 
appears on the status line as a prompt for a search 
string. The question mark (?) works exactly like the 
slash key, except that it is used to search backward in 
a file instead of forward. 


The colon is a prompt for an ex command. You can 
then type in any ex command, followed by an ESC or 
RETURN, and the given ex command is executed. 


The following characters are special in insert mode: 


BKSP 


Ctrl-U 


Ctrl-V 


Ctrl-W 


Ctrl-T 


Backs up the cursor one character on the current line. 
The last character typed before the BKSP is removed 
from the input buffer, but remains displayed on the 
screen. 


Moves the cursor back to the first character of the inser- 
tion and restarts insertion. 


Removes the special significance of the next typed char- 
acter. Use Ctrl-V to insert control characters. Linefeed 
and Ctrl-J cannot be inserted in the text except as new- 
line characters. Ctrl-Q and Ctrl-S are trapped by the 
Operating system before they are interpreted by vi, so 
they too cannot be inserted as text. 


Moves the cursor back to the first character of the last 
inserted word. 


During an insertion, with the autoindent option set and 
at the beginning of the current line, entering this charac- 
ter will insert shiftwidth whitespace. 
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Ctrl-@ If entered as the first character of an insertion, it is 
replaced with the last text inserted, and the insertion ter- 
minates. Only 128 characters are saved from the last 
insertion. If more than 128 characters were inserted, 
then this command inserts no characters. A Ctrl-@ can- 
not be part of a file, even if quoted. 


Starting and Exiting Vi 


To enter vi, enter: 


vl Edits empty editing buffer 

vi file Edits named file 

vi +123 file Goes to line 123 

vi +45 file Goes to line 45 

vi +/word file Finds first occurrence of ‘“‘word”’ 
vi +/tty file Finds first occurrence of “‘tty”’ 


There are several ways to exit the editor: 


ZZ The editing buffer is written to the file only if any changes 
were made. 


:x The editing buffer is written to the file only if any changes 
were made. 


:q! Cancels an editing session. The exclamation mark (!) tells vi 
to quit unconditionally. In this case, the editing buffer is not 
written out. 


Vi Commands 


Vi is a visual editor with a window on the file. What you see on the 
screen is vi’s notion of what the file contains. Commands do not 
cause any change to the screen until the complete command is 
entered. Most commands may take a preceding count that specifies 
repetition of the command. This count parameter is not given in 
the following command descriptions, but is implied unless overri- 
den by some other prefix argument. When wi gets an improperly 
formatted command, it rings a bell. 
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Cursor Movement 


The cursor movement keys allow you to move your cursor around 
in a file. Note in particular the direction keys (if available on your 
terminal), the H, J, K, and L cursor keys, and SPACEBAR, BKSP, 
Ctrl-N, and Ctrl-P. These three sets of keys perform identical func- 
tions. 


Forward Space — I, SPACEBAR, or right direction key 


Syntax: 1 
SPACEBAR 
right direction key 


Function: 

Moves the cursor forward one character. If a count is given, 
move forward count characters. You cannot move past the end 
of the line. 


Backspace — h, BKSP, or left direction key 


Syntax: h 
BKSP 
left direction key 


Function: Moves cursor backward one character. If a count is 
given, moves backward count characters. Note that you 
cannot move past the beginning of the current line. 


Next Line — +, RETURN, j, Ctrl-N, and LF 


Syntax: + 
RETURN 


Function: Moves the cursor down to the beginning of the next line. 


Syntax: j 
Ctrl-N 
LF 
down direction key 


Function: Moves the cursor down one line, remaining in the same 
column. Note the difference between these commands 
and the preceding set of next line commands which 
move to the beginning of the next line. 


Previous Line — k, Ctrl-P, and up direction key 
Syntax: k 


Ctrl-P 
up direction key 
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Function: Moves the cursor up one line, remaining in the same 
column. If a count is given, the cursor is moved count 
lines. 


Syntax: = 


Function: Moves the cursor up to the beginning of the previous 
line. If a count is given, the cursor is moved up a count 
lines. 


Beginning of Line — 0 and ~ 


Syntax: 


Function: Moves the cursor to the beginning of the current line. 
Note that 0 always moves the cursor to the first charac- 
ter of the current line. The caret (*) works somewhat 
differently: it moves to the first character on a line that 
is not a tab or a space. This is useful when editing files 
that have a great deal of indentation, such as program 
texts. 


End of Line — $ 

Syntax: $ 

Function: Moves the cursor to the end of the current line. Note 
that the cursor resides on top of the last character on 
the line. If a count is given, the cursor is moved for- 
ward count-1 lines to the end of the line. 

Goto Line — G 

Syntax: _[linenumber]G 

Function: Moves the cursor to the beginning of the line specified 
by linenumber. If no linenumber is given, the cursor 
moves to the beginning of the Jast line in the file. To 
find the line number of the current line, use Ctrl-G. 

Column — | 

Syntax: [column]| 

Function: Moves the cursor to the column in the current line given 


by column. If no column is given, the cursor is moved 
to the first column in the current line. 
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Word Forward — w and W 


Syntax: w 
Ww 


Function: Moves the cursor forward to the beginning of the next 
word. The lowercase w command searches for a word 
defined as a string of alphanumeric characters separated 
by punctuation or whitespace (i.e., tab, newline, or 
space characters). The uppercase W command searches 
for a word defined as a string of nonwhitespace charac- 
ters. 


Back Word — b and B 


Syntax: b 
B 


Function: Moves the cursor backward to the beginning of a word. 
The lowercase b command searches backward for a 
word defined as a string of alphanumeric characters 
separated by punctuation or whitespace (i.e., tab, new- 
line, or space characters). The uppercase B command 
searches for a word defined as a string of non- 
whitespace characters. If the cursor is already within a 
word, it moves backward to the beginning of that word. 


End — e and E 


Syntax: e 


Function: Moves the cursor to the end of a word. The lowercase e 
command moves the cursor to the last character of a 
word, where a word is defined as a string of 
alphanumeric characters separated by punctuation or 
whitespace (i.e., tab, newline, or space characters). The 
uppercase E moves the cursor to the last character of a 
word where a word is defined as a string of nonwhite- 
space characters. If the cursor is already within a word, 
it moves to the end of that word. 


Sentence — (and ) 

Syntax:  ( 
) 

Function: Moves the cursor to the beginning (left parenthesis) or 
end of a sentence (right parenthesis). A sentence is 
defined as a sequence of characters ending with a period 


(.), question mark (?), or exclamation mark (!), fol- 
lowed by either two spaces or a newline. A sentence 
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begins on the first nonwhitespace character following a 
preceding sentence. Sentences are also delimited by 
paragraph and section delimiters. See below. 


Paragraph — { and } 


Syntax: } 
{ 


Function: Moves the cursor to the beginning ({) or end (}) of a 
paragraph. A paragraph is defined with the paragraphs 
option. By default, paragraphs are delimited by the 
nroff macros “.IP”, “.LP”’, “.P”, ‘“.QP”, and “.bp”. 
Paragraphs also begin after empty lines. 


Section — [[ and }] 


Syntax: J] 
[[ 


Function: Moves the cursor to the beginning ([[) or end (]]) of a 
section. A section is defined with the sections option. 
By default, sections are delimited by the nroff macros 
“NH” and “.SH”. Sections also start at formfeeds 
(Ctrl-L) and at lines beginning with a brace ({). 


Match Delimiter — % 
Syntax: % 


Function: Moves the cursor to a matching delimiter, where a del- 
imiter is a parenthesis, a bracket, or a brace. This is 
useful when matching pairs of nested parentheses, 
brackets, and braces. 


Home — H 
Syntax:  [offset]H 


Function: Moves the cursor to the upper left corner of the screen. 
Use this command to quickly move to the top of the 
screen. If an offset is given, the cursor is homed offset-1 
number of lines from the top of the screen. Note that 
the command “dH” deletes all lines from the current 
line to the top line shown on the screen. 
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Middle Screen — M 


Syntax: 


Function: 


M 


Moves the cursor to the beginning of the screen’s middle 
line. Use this command to quickly move to the middle 
of the screen from either the top or the bottom. Note 
that the command ‘“‘dM” deletes from the current line to 
the line specified by the M command. 


Lower Screen — L 


Syntax: 


Function: 


Previous Context — ~ and 


Syntax: 


Function: 


[offset|L 


Moves the cursor to the lowest line on the screen. Use 
this command to quickly move to the bottom of the 
screen. If an offset is given, the cursor is homed offset-1 
number of lines from the bottom of the screen. Note 
that the command “dL” deletes all lines from the 
current line to the bottom line shown on the screen. 


7? 


ae? 


“character 
‘character 


Moves the cursor to previous context or to context 
marked with the m command. If the single quotation 
mark or back quotation mark is doubled, the cursor is 
moved to previous context. If a single character is given 
after either quotation mark, the cursor is moved to the 
location of the specified mark as defined by the m com- 
mand. Previous context is the location in the file of the 
last ‘‘nonrelative” cursor movement. The single quota- 
tion mark (*) syntax is used to move to the beginning of 
the line representing the previous context. The back 
quotation mark (>) syntax is used to move to the previ- 
ous context within a line. 
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The Screen Commands 


The screen commands are not cursor movement commands and 
cannot be used in delete commands as the delimiters of text 
objects. However, the screen commands do move the cursor and 
are useful in paging or scrolling through a file. These commands 
are described below: 


Page — Ctrl-U and Ctrl-D 


Syntax: [size] Ctrl-U 
[size] Ctrl-D 


Function: Scrolls the screen up a half window (Ctrl-U) or down a 
half window (Ctrl-D). If size is given, the scroll is size 
number of lines. This value is remembered for all later 
scrolling commands. 


Scroll — Ctri-F and Ctrl-B 


Syntax: Ctri-F 
Ctrl-B 


Function: Pages screen forward and backward. Two lines of con- 
tinuity are kept between pages if possible. A preceding 
count gives the number of pages to move forward or 
backward. 


Status — Ctrl-G 


Syntax: BELL 
Ctri-G 


Function: Displays vi status on status line. This gives you the 
name of the file you are editing, whether it has been 
modified, the current line number, the number of lines 
in the file, and the percentage of the file (in lines) that 
precedes the cursor. 


Zero Screen = z 


Syntax: = [linenumber)z[size] RETURN 
[linenumber]z[size]. 
(linenumber]z{size]— 


Function: Redraws the display with the current line placed at or 
“zeroed” at the top, middle, or bottom of the screen, 
respectively. If you give a size, the number of lines 
displayed is equal to size. If a preceding linenumber is 
given, the given line is placed at the top of the screen. 
If the last argument is a RETURN, the current line is 
placed at the top of the screen. If the last argument is a 
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period (.), the current line is placed in the middle of 
the screen. If the last argument is a minus sign (-), the 
current iine is placed at the bottom of the screen. 


Redraw — Ctrl-R or Ctri-L 


Syntax: Ctri-R 
Ctrl-L 


Function: Redraws the screen. Use this command to erase any 
system messages that may scramble your screen. Note 
that system messages do not affect the file you are edit- 
ing. 


Text Insertion 


The text insertion commands always place you in insert mode. Exit 
from insert mode is always done by pressing ESC. The following 
insertion commands are “pure” insertion commands; no text is 
deleted when you use them. This differs from the text modification 
commands, change, replace, and substitute, which delete and then 
insert text in one operation. 


Insert — i and I 


Syntax: _i[text]ESC 
I[text]ESC 


Function: Insert text in editing buffer. The lowercase i command 
places you in insert mode. Text is inserted before the 
character beneath the cursor. To insert a newline, press 
a RETURN. Exit insert mode by typing the ESC key. 
The uppercase I command places you in insert mode, 
but begins text insertion at the beginning of the current 
line, rather than before the cursor. 


Append — aandA 


Syntax:  a[text]ESC 
A[text]ESC 


Function: Appends text to the editing buffer. The lowercase a 
command works exactly like the lowercase i command, 
except that text insertion begins after the cursor and not 
before. This is the one way to add text to the end of a 
line. The uppercase A command begins appending text 
at the end of the current line rather than after the cur- 
sor. 
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Open New Line — o and O 


Syntax: 


Function: 


o[text]ESC 
O[text]ESC 


Opens a new line and inserts text. The lowercase o 
command opens a new line below the current line; 
uppercase O opens a new line above the current line. 
After the new line has been opened, both these com- 
mands work like the I command. 


Text Deletion 


Many of the text deletion commands use the D key as an operator. 
This operator deletes text objects delimited by the cursor and a cur- 
sor movement command. Deleted text is always saved away in a 
buffer. The delete commands are described below: 


Delete Character — x and X 


Syntax: 


Function: 


xX 


Deletes a character. The lowercase x command deletes 
the character beneath the cursor. With a preceding 
count, count characters are deleted to the nght begin- 
ning with the character beneath the cursor. This is a 
quick and easy way to delete a few characters. The 
uppercase X command deletes the character just before 
the cursor. With a preceding count, count characters 
are deleted backward, beginning with the character just 
before the cursor. 
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Delete — d and D 


Syntax:  dcursor-movement 
dd 
D 


Function: Deletes a text object. The lowercase d command takes 
a cursor-movement as an argument. If the cursor- 
movement is an intraline command, deletion takes place 
from the cursor to the end of the text object delimited 
by the cursor-movement. Deletion forward deletes the 
character beneath the cursor: deletion backward does 
not. If the cursor-movement is a multi-line command, 
deletion takes place from and including the current line 
to the text object delimited by the cursor-movement. 


The dd command deletes whole lines. The uppercase D command 
deletes from and including the cursor to the end of the current line. 


Deleted text is automatically pushed on a stack of buffers numbered 
1 through 9. The most recently deleted text is also placed in a spe- 
cial delete buffer that is logically buffer 0. This special buffer is the 
default buffer for all (put) commands using the double quotation 
mark (") to specify the number of the buffer for delete, put, and 
yank commands. The buffers 1 through 9 can be accessed with the 
p and P (put) commands by appending the double quotation mark 
(") to the number of the buffer. For example: 


"Ap 


puts the contents of delete buffer number 4 in your editing buffer 
Just below the current line. Note that the last deleted text is “put” 
by default and does not need a preceding buffer number. 


Text Modification 


The text modification commands all involve the replacement of text 
with other text. This means that some text will necessarily be 
deleted. All text modification commands can be “undone” with 
the u command: 


Undo — u and U 


Syntax: — u 
U 


Function: Undoes the last insert or delete command. The lower- 
case u command undoes the last insert or delete com- 
mand. This means that after an insert, u deletes text: 
and after a delete, u inserts text. For the purposes of 
undo, all text modification commands are considered 
insertions. 
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The uppercase U command restores the current line to 
its state before it was edited, no matter how many times 
the current line has been edited since you moved to it. 


Repeat —. 
Syntax: . 


Function: Repeats the last insert or delete command. A special 
case exists for repeating the p and P “put” commands. 
When these commands are preceded by the name of a 
delete buffer, successive u commands display the con- 
tents of the delete buffers. 


Change — c and C 


Syntax:  ccursor-movement text ESC 
Ctext ESC 
cctext ESC 


Function: Changes a text object and replaces it with text . Text is 
inserted as with the icommand. A dollar sign ($) marks 
the extent of the change. The’ec command changes arbi- 
trary text objects delimited by the cursor and a cursor- 
movement . The C and ce commands affect whole lines 
and are identical in function. 


Replace — r and R 


Syntax: rchar 
Rtext ESC 


Function: Overstrikes character or line with char or text , respec- 
tively. Use r to overstrike a single character and R to 
overstrike a whole line. A count multiplies the replace- 
ment text count times. 


Substitute — s and S 


Syntax:  stextESC 
Stext ESC 


Function: Substitutes current character or current line with text. 
Use s to replace a single character with new text. Use S 
to replace the current line with new text. Ifa preceding 
count is given, text substitutes for count number of char- 
acters or lines depending on whether the command is s 
or S, respectively. 
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Filter — ! 
Syntax: !cursor-movement cmd RETURN 


Function: Filters the text object delimited by the cursor and 
cursor-movement through the XENIX command, cmd. 
For example, the following command sorts all lines 
between the cursor and the bottom of the screen, substi- 
tuting the designated lines with the sorted lines: 


!Lsort 


Arguments and shell metacharacters may be included as 
part of cmd; however, standard input and output are 
always associated with the text object being filtered. 


Join Lines — J 
Syntax: J 


Function: Joins the current line with the following line. If a count 
is given, count lines are joined. 


Shift — < and > 


Syntax: >[cursor-movement] 
<[cursor-movement] 
>> 
<< 


Function: Shifts text left (>) or right (<). Text is shifted by the 
value of the option shiftwidth, which is normally set to 
eight spaces. Both the > and < commands shift all 
lines in the text object delimited by the current line and 
cursor-movement. The >> and << commands affect 
whole lines. All versions of the command can take a 
preceding count that acts to multiply the number of 
objects affected. 
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Text Movement 


The text movement commands move text in and out of the named 
buffers a-z and out of the delete buffers 1-9. These commands 
either “yank” text out of the editing buffer and into a named buffer 
or “put” text into the editing buffer from a named buffer or a 
delete buffer. By default, text is put and yanked from the 
“yunnamed buffer”, which is also where the most recently deleted 
text is placed. Thus it is quite reasonable to delete text, move your 
cursor to the location where you want the deleted text placed, and 
then put the text ba « into the editing buffer at this new location 
with the p or P command. 


The named buffers are most useful for keeping track of several 
chunks of text that you want to keep on hand for later access, 
movement, or rearrangement. These buffers are named with the 
letters a through z. To refer to one of these buffers (or one of the 
numbered delete buffers) in a command, use a quotation mark. 
For example, to yank a line into the buffer named a, enter: 


ayy 
To put this text back into the file, enter: 


ap 


If you delete text in the buffer named A rather than a, text is 
appended to the buffer. 


Note that the contents of the named buffers are not destroyed when 
you switch files. Therefore, you can delete or yank text into a 
buffer, switch files, and then do a put. Buffer contents are des- 
troyed when you exit the editor, so be careful. 


Put — p and P 


Syntax: ["alphanumeric]p 
["alphanumeric|P 


Function: Puts text from a buffer into the editing buffer. If no 
buffer name is specified, text is put from the unnamed 
buffer. The lowercase p command puts text either 
below the current line or after the cursor, depending on 
whether the buffer contains a partial line or not. The 
uppercase P command puts text either above the current 
line or before the cursor, again depending on whether 
the buffer contains a partial line or not. 
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Yank — y and Y 


Syntax: 


Function: 


Searching 


["letter]ycursor-movement 
[“letter]yy 
["letter]Y 


Copies text in the editing buffer to a named buffer. If 
no buffer name is specified, text is yanked into the 
unnamed buffer. If an uppercase letter is used, text is 
appended to the buffer and does not overwrite and des- 
troy the previous contents. When a cursor-movement is 
given as an argument, the delimited text object is 
yanked. The Y and yy commands yank a single line, or, 
if a preceding count is given, multiple lines can be 
yanked. 


The search commands search either forward or backward in the 
editing buffer for text that matches a given regular expression. 


Search — / and ? 


Syntax: 


Function: 


/(pattern]/[offset]RETURN 
/[pattern]RETURN 
?[pattern]? [offset] RETURN 
?[pattern]JRETURN 


Searches forward (/) or backward (?) for pattern. A 
string 1s actually a regular expression. The trailing delim- 
iter is not required. If no pattern is given, then last pat- 
tern searched for is used. After the second delimiter, an 
offset may be given, specifying the beginning of a line 
relative to the line on which pattern was found. For 
example: 


/word/- 


finds the beginning of the line immediately preceding the 
line containing ‘‘word” and the following command: 


/word/+2 


finds the beginning of the line two lines after the line 
containing “word”. See also the ignorecase and magic 
options. 
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Next String — n and N 


Syntax: 


Function: 


n 


Repeats the last search command. The n command 
repeats the search in the same direction as the last 
search command. The N command repeats the search 
in the opposite direction of the last search command. 


Find Character — f and F 


Syntax: 


Function: 


fchar 
Fchar 


9 


Finds character char on the current line. The lowercase 
f searches forward on the line; the uppercase F searches 
backward. The semicolon (;) repeats the last character 
search. The comma (,) reverses the direction of the 
search. 


To Character — t and T 


Syntax: 


Function: 


Mark — m 
Syntax: 


Function: 


tchar 
Tchar 


> 


Moves the cursor up to but not on char. The semicolon 
(;) repeats the last character search. The comma Us) 
reverses the direction of the search. 


mietter 


Marks a place in the file with a lowercase letter. You 
can move to a mark using the “to mark”? commands 
described below. It is often useful to create a mark, 
move the cursor, and then delete from the cursor to the 
mark ‘“‘a” with the following command: 


d’a 
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To Mark —” and ~ 


Syntax: 


Function: 


‘letter 
‘letter 


Move to letter. These commands let you move to the 
location of a mark. Marks are denoted by single lower- 
case alphabetic characters. Before you can move to a 
mark, it must first be created with the m command. 
The back quotation mark (~) moves you to the exact 
location of the mark within a line; the forward quotation 
mark (*) moves you to the beginning of the line contain- 
ing the mark. Note that these commands are also legal 
cursor movement commands. 
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Exit and Escape Commands 


There are several commands that are used to escape from wi com- 
mand mode and to exit the editor. These are described in the fol- 
lowing section. 


Ex Escape — : 
Syntax: 


Function: Enters ex escape mode to execute an ex command. The 
colon appears on the status line as a prompt for an ex 
command. You then can enter an ex command line ter- 
minated by either a RETURN or an ESC and the ex com- 
mand will execute. You are then prompted to type 
RETURN to return to vi command mode. During the 
input of the ex command line or during execution of the 
ex command, you may press INTERRUPT to stop what 
you are doing and return to vi command mode. 


Exit Editor — ZZ 

Syntax: ZZ 

Function: Exit vi and write out the file if any changes have been 
made. This returns you to the shell from which you 
started vi. 

Quit to Ex — Q 

Syntax: Q0 

Function: Enters the ex editor. When you do this, you will still be 


editing the same file. You can return to wi by entering 
the vi command from ex. 
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Ex Commands 


Entering the colon (:) escape command when in command mode 
produces a colon prompt on the status line. This prompt is for a 
command available in the line-oriented editor, ex. In general, ex 
commands let you write out or read in files, escape to the shell, or 
switch editing files. 


Many of these commands perform actions that affect the “current”’ 
file by default. The current file is normally the file that you named 
when you started wi, although the current file can be changed with 
the “‘file’? command, f, or with the ‘‘next”? command, n. In most 
respects, these commands are identical to similar commands for the 
editor, ed. All such ex commands are aborted by either RETURN 
or ESC. We shall use RETURN in our examples. Command entry 
is terminated by typing INTERRUPT. 


Command Structure 


Most ex command names are English words, and initial prefixes of 
the words are acceptable abbreviations. In descriptions, only the 
abbreviation is discussed, since this is the most frequently used 
form of the command. The ambiguity of abbreviations is resolved 
in favor of the more commonly used commands. As an example, 
the command substitute can be abbreviated s , while the shortest 
available abbreviation for the set command is se. 


Most commands accept prefix addresses specifying the lines in the 
file that they are to affect. A number of commands also may take a 
trailing count specifying the number of lines to be involved in the 
command. Counts are rounded down if necessary. Thus, the com- 
mand ‘“10p” displays the tenth line in the buffer while “move 5” 
moves the current line after line 5. 


Some commands take other information or parameters, stated after 
the command name. Examples might be option names in a set 
command, such as “‘set number’’, a filename in an edit command, a 
regular expression in a substitute command, or a target address for 
a copy command. For example: 


1,5 copy 25 


A number of commands have variants. The variant form of the 
command is invoked by placing an exclamation mark (!) immedi- 
ately after the command name. Some of the default variants may 
be controlled by options; in this case, the exclamation mark turns 
off the meaning of the default. 
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In addition, many commands take flags, including the characters 
“pn” and “1”. A “p” or “I” must be preceded by a blank or tab. In 
this case, the command abbreviated by these characters is executed 
after the command completes. Since ex normally displays the new 
current line after each change, p is rarely necessary. Any number 
of plus (+) or minus (—) characters may also be given with these 
flags. If they appear, the specified offset is applied to the current 
line value before the printing command is executed. 


Most commands that change the contents of the editor buffer give 
feedback if the scope of the change exceeds a threshold given by 
the report option. This feedback helps to detect undesirably large 
changes so that they may be quickly and easily reversed with the 
undo command. After commands with global effect, you will be 
informed if the net change in the number of lines in the buffer dur- 
ing this command exceeds this threshold. 


Command Addressing 
The following specifies the line addressing syntax for ex commands: 
The current line. Most commands leave the 
current line as the last line which they affect. The 
default address for most commands is the current 


line, thus ‘‘.” is rarely used alone as an address. 


n The nth line in the editor’s buffer, lines being num- 
bered sequentially from 1. 


$ The last line in the buffer. 
Jo An abbreviation for “‘1,$’’, the entire buffer. 
+n or —n An offset, 1 relative to the current buffer line. The 


forms “.+3” “+3” and “+++” are all equivalent. If 
the current line is line 100 they all address line 103. 


/pattern/ or 2?pattern? 

Scan forward and backward respectively for a text 
matching the regular expression given by pattern. 
Scans normally wrap around the end of the buffer. 
If all that is desired is to print the next line con- 
taining pattern, the trailing slash (/) or question 
mark (?) may be omitted. If pattern is omitted or 
explicitly empty, the string matching the last 
specified regular expression is located. The forms 
“RETURN” and “?RETURN” scan using the last 
named regular expression. After a_ substitute, 
“RETURN” and “??RETURN” would scan using 
that substitute’s regular expression. 
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or “x Before each nonrelative motion of the current line 
dot (.), the previous current line is marked with a 
label, subsequently referred to with two single quo- 
tation marks (“). This makes it easy to refer or 
return to this previous context. Marks are esta- 
blished with the vi m command, using a single 
lowercase letter as the name of the mark. Marked 
lines are later referred to with the following nota- 
tion: 


4 


pe 
where x is the name of a mark. 


Addresses to commands consist of a series of addresses, separated 
by a colon (,) or a semicolon (;). Such address lists are evaluated 
left to right. When addresses are separated by a semicolon (;) the 
current line (.) is set to the value of the previous addressing 
expression before the next address is interpreted. If more 
addresses are given than the command requires, all but the last one 
or two are ignored. If the command takes two addresses, the first 
addressed line must precede the second in the buffer. Null address 
specifications are permitted in a list of addresses, the default in this 
case is the current line ‘‘.”; thus ‘‘,100” is equivalent to ‘‘.,100’. It 
is an error to give a prefix address to a command which expects 
none. 


Command Format 
The following is the format for all ex commands: 
[address] [command] [!] [parameters] [count] [flags] 


All parts are optional depending on the particular command and its 
options. The following section describes specific commands. 


Argument List Commands 


The argument list commands allow you to work on a set of files, by 
remembering the list of filenames that are specified when you 
invoke vi. The args command lets you examine this list of 
filenames. The file command gives you information about the 
current file. The n (next) command lets you either edit the next file 
in the argument list or change the list. And the rewind command 
lets you restart editing the files in the list. All of these commands 
are described below: 


args The members of the argument list are displayed, 


with the current argument delimited by brackets. 
For example, a list might look like this: 
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filel file2 [file3] file4 fileS 
The current file is file3. 


f Displays the current filename, whether it has been 
modified since the last write command, whether it iS 
read-only, the current linenumber, the number of 
lines in the buffer, and the percentage of the buffer 
that you have edited. In the rare case that the 
current file is “[Not edited], this is noted also; in 
this case you have to use w! to write to the file, 
since the editor is not sure that a w command will 
not destroy a file unrelated to the current contents 
of the buffer. 


f file The current filename is changed to file which is con- 
sidered ‘“‘[Not edited]’’. 


n The next file in the command line argument list is 
edited. 
n! This variant suppresses warnings about the 


modifications to the buffer not having been wnitten 
out, discarding irretrievably any changes that may 
have been made. 


n [+command] filelist 
The specified filelist is expanded and the resulting 
list replaces the current argument list; the first file in 
the new list is then edited. If command is given (it 
must contain no spaces), then it is executed after 
editing the first such file. 


rew The argument list is rewound, and the first file in 
the list is edited. 


rew! Rewinds the argument list discarding any changes 
made to the current buffer. 
Edit Commands 


To edit a file other than the one you are currently editing, you will 
often use one of the variations of the e command. 


In the following discussions, note that the name of the current file 
is always remembered by vi and is specified by a percent sign (%). 
The name of the previous file in the editing buffer is specified by a 
number sign (#). 
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The edit commands are described below: 


e file 


e! file 


e +n file 


Ctrl- 


Used to begin an editing session on a new file. The 
editor first checks to see if the buffer has been 
modified since the last w command was issued. If it 
has been, a warning is issued and the command is 
aborted. The command otherwise deletes the entire 
contents of the editor buffer, makes the named file the 
current file, and displays the new filename. After 
ensuring that this file is sensible, (i.e., that it is not a 
binary file, directory, or a device), the editor reads the 
file into its buffer. If the read of the file completes 
without error, the number of lines and characters read 
is displayed on the status line. If there were any 
non-ASCII characters in the file, they are stripped of 
their non-ASCII high bits, and any null characters in 
the file are discarded. If none of these errors 
occurred, the file is considered edited. If the last line 
of the input file is missing the trailing newline charac- 
ter, it is supplied and a complaint issued. The current 
line is initially the first line of the file. 


This variant form suppresses the complaint about 
modifications having been made and not written from 
the editor buffer, thus discarding all changes that have 
been made before editing the new file. 


Causes the editor to begin editing at line 1 rather than 
at the first line. The argument 7 may also be an editor 
command containing no spaces; for example, ‘‘+/pat- 
tern”’. 


This is a shorthand equivalent for “:e #RETURN”, 
which returns to the previous position in the last 
edited file. If you do not want to write the file, you 
should use “:e! #RETURN” instead. 


Write Commands 


The write commands let you write out all or part of your editing 
buffer to either the current file or to some other file. —These com- 
mands are described below: 


w file 
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Writes changes made back to file, displaying the 
number of lines and characters written. Normally, file 
is omitted and the buffer is written to the name of the 
current file. If file is specified, text is written to that 
file. The editor writes to a file only if it is the current 
file and is edited, or if the file does not exist. Other- 
wise, you must give the variant form w! to force the 
write. If the file does not exist it is created. The 
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current filename is changed only if there is no current 
filename; the current line is never changed. 


If an error occurs while writing the current and edited 
file, the editor displays: 


No write since last change 
even if the buffer had not previously been modified. 


w>> file |Appends the buffer contents at the end of an existing 
file. Previous file contents are not destroyed. 


w! name Overrides the checking of the normal write command, 
and writes to any file that the system permits. 


w !command 
Writes the specified lines into command. Note the 
difference between 


w! file 
which overrides checks and 
w !cmd 


which writes to a command. The output of this com- 
mand is displayed on the screen and not inserted in 
the editing buffer. 


Read Commands 


The read commands let you read text into your editing buffer at any 
location you specify. The text you read in must be at least one line 
long, and can be either a file or the output from a command. 


r file Places a copy of the text of the given file in the editing 
buffer after the specified line. If no file is given, the 
current filename is used. The current filename is not 
changed unless there is none, in which case the file 
becomes the current name. If the file buffer is empty 
and there is no current name, this is treated as an e 
command. 


Address 0 is legal for this command and causes the 
file to be read at the beginning of the buffer. Statistics 
are given as for the e command when the r success- 
fully terminates. After an r the current line is the last 
line read. 
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r!command Reads the output of command into the buffer after the 
specified line. A blank or tab before the exclamation 
mark (!) is mandatory. 


Quit Commands 


There are several ways to exit vi. Some abort the editing session, 
some write out the editing buffer before exiting, and some warn you 
if you decide to exit without writing out the buffer. All of these 
ways of exiting are described below: 


q Exits vi. No automatic write of the editor buffer to a file 
is performed. However, vi displays a warning message if 
the file has changed since the last w command was 
issued, and does not quit. Vi also displays a diagnostic 
if there are more files in the argument list left to edit. 
Normally, you will wish to save your changes, and you 
Should enter a w command. If you wish to discard 
them, enter the q! command variant. 


q! Quits from the editor, discarding changes to the buffer 
without complaint. 


wq name _ Like a w and then a q command. 


wq! name Overrides checking normally made before execution of 
the w command to any file. For example, if you own a 
file but do not have write permission turned on, the wa! 
allows you to update the file anyway. 


x name _ If any changes have been made and not written, writes 
the buffer out and then quits. Otherwise, it just quits. 


Global and Substitute Commands 


The global and substitute commands allow you to perform complex 
changes to a file in a single command. Learning how to use these 
commands is a must for an experienced wi user. 


g/pattern/cmds 
The g command has two distinct phases. In the first 
phase, each line matching pattern in the editing buffer is 
marked. Next, the given command list is executed with 
the current line, dot (.), initially set to each marked 
line. 


The command list consists of the remaining commands 
on the current input line and may continue to multiple 
lines by ending all but the last such line with a backslash 
(\). This multiple-line option will not work from within 
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vi, you must switch to ex to do it. If cmds (or the trail- 
ing slash (/) delimiter) is omitted, each line matching 
pattern is displayed. 


The g command itself may not appear in cmds. The 
options autoprint and autoindent are inhibited during a 
global command and the value of the report option is 
temporarily infinite, in deference to a report for the 
entire global. Finally, the context mark (“) or (°) is set 
to the value of the current line (.) before the global 
command begins and is not changed during a global 
command. 


The following global commands, most of them substitu- 
tions, cover the most frequent uses of the global com- 
mand. 


g/s1/p This command simply prints all lines that contain 
the string “sl”. 

g/s1/s//s2/ This command substitutes the first occurrence of 
‘s1” on all lines that contain it with the string 
sia a 

g/s1/s//s2/g This command substitutes all occurrences of ‘‘s1”’ 


with the string “s2”. This includes multiple 
occurrences of ‘‘sl1”’ on a line. 


g/s1/s//s2/gp | This command works the same as the preceding 


example, except that in addition, all changed lines 
are displayed on the screen. 


g/s1/s//s2/ge | This command prompts you to confirm that you 


want to make each substitution of the string “s1” 
with the string ‘“‘s2”. If you enter a Y , the given 
substitution is made, otherwise it is not. 


g/s0/s/s1/s2/g This command marks all those lines that contain 


the string ‘‘sO”’, and then for those lines only, sub- 
stitutes all occurrences of the string ‘‘s1” with “s2”’. 


g!/pattern/cmds This variant form of g runs cmds at each line not 


matching pattern. 


s/pattern/repl/options f 


On each specified line, the first instance of text 
matching the regular expression pattern is replaced 
by the replacement text repl. If the global indica- 
tor option character g appears, all instances on a 
line are substituted. If the confirm indication char- 
acter ¢ appears, before each substitution the line to 
be substituted is printed on the screen with the 
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string to be substituted marked with caret (*) char- 
acters. By entering Y , you cause the substitution 
to be performed; any other input causes no change 
to take place. After an s command, the current 
line is the last line substituted. 


A synonym for the global command variant g!, 
running the specified cmds on each line that does 
not match pattern. 


Text Movement Commands 


The text movement commands are largely superseded by commands 
available in vi command mode. However, the following two com- 
mands are still quite useful: 


co addr flags 


[range]maddr 


A copy of the specified lines is placed after addr, 


which may be “0”. The current line “.”’ addresses 
the last line of the copy. 


The m command moves the lines specified by 
range after the line given by addr. For example, 
m-+ swaps the current line and the following line, 
since the default range is just the current line. The 
first of the moved lines becomes the current line 
(dot). 


Shell Escape Commands 


You will often want to escape from the editor to execute normal 
XENIX commands. You may also want to change your working 
directory so that your editing can be done with respect to a 
different working directory. These operations are described below: 


cd directory 


sh 


'command 
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The specified directory becomes the current direc- 
tory. If no directory is specified, the current value 
of the home option is used as the target directory. 
After a cd , the current file is not considered to 
have been edited so that wnite restrictions on 
preexisting files still apply. 


A new shell is created. You may invoke as many 
commands as you like in this shell. To return to 
vi, enter a Ctrl-D to terminate the shell. 


The remainder of the line after the exclamation (!) 
is sent to a shell to be executed. Within the text of 
command , the characters “%” and “#” are 
expanded as the filenames of the current file and 
the last edited file and the character “!” is replaced 
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with the text of the previous command. Thus, in 
particular, “‘!!”? repeats the last such shell escape. 
If any such expansion is performed, the expanded 
line is echoed. The current line is unchanged by 
this command. 


If there has been “‘[No write]” of the buffer contents since the last 
change to the editing buffer, a diagnostic is displayed before the 
command is executed as a warning. A single exclamation (!) is 
displayed when the command completes. 


Other Commands 


The following command descriptions explain how to use miscellane- 
ous ex commands that do not fit into the above categories: 


abbr Maps the first argument to the following string. For 
example, the following command 


:abbr rainbow yellow green blue red 


maps “rainbow” to “yellow green blue red”. Abbrevia- 
tions can be turned off with the unabbreviate command, 
as In: 


‘una rainbow 


map, map! 
Maps any character or escape sequence to an existing 
command sequence. Characters mapped with map! work 
in both command and insert mode, while characters 
mapped with map work only in command mode. Char- 
acters mapped with map! cannot be unmapped using 
unmap. 


nu Displays each specified line preceded by its buffer line 
number. The current line is left at the last line 
displayed. To get automatic line numbering of lines in 
the buffer, set the number option. 


preserve The current editor buffer is saved as though the system 
had just crashed. This command is for use only in 
emergencies when a w command has resulted in an error 
and you do not know how to save your work. 


= Displays the line number of the addressed line. The 
current line is unchanged. 


recover file 


Recovers file from the system save area. The system 
saves a copy of the editing buffer only if you have made 
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changes to the file, the system crashes, or you execute a 
preserve command. When you use preserve , you are 
notified by mail when a file is saved. 


set argument 3 
With no arguments, set displays those options whose 
values have been changed from their defaults; with the 
argument all, it displays all of the option values. 


Giving an option name followed by a question mark (?) causes the 
current value of that option to be displayed. The question mark is 
unnecessary unless the option is a Boolean value. Switch options 
are given values either with: 


set option 

to turn them on or: 
set nooption 

to turn them off. String and numeric options are assigned with: 
set option=value 


More than one parameter may be given to Set ; all are interpreted 
from left to nght. 


tag label 7 
The focus of editing switches to the location of label. If neces- 
sary, vi will switch to a different file in the current directory to 
find label. If you have modified the current file before giving a 
tag command, you must first write it out. If you give another tag 
command with no argument, the previous label is used. 


Similarly, if you press Ctrl-], vi searches for the word immedi- 
ately after the cursor as a tag. This is equivalent to entering 
‘stag’, the word following the cursor, and then pressing the 
RETURN key. 


The tags file is normally created by a program such as ctags, and 
consists of a number of lines with three fields separated by 
blanks or tabs. The first field gives the name of the tag, the 
second the name of the file where the tag resides, and the third 
gives an addressing form which can be used by the editor to find 
the tag. This field is usually a contextual scan using / pattern/ to 
be immune to minor changes in the file. Such scans are always 
performed as if the nomagic option was set. The tag names in 
the tags file must be sorted alphabetically. There are a number 
of options that can be set to affect the wi environment. These 
can be set with the ex set. command either while editing or 
immediately after vi is invoked in the wi start-up file, .exre. 
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unmap 
Unmaps any character or escape sequence that has been 
mapped using the map command. 


The first thing that must be done before you can use wi, is to set 
the terminal type so that wi understands how to talk to the particu- 
lar terminal you are using. 


Each time wi is invoked, it reads commands from the file named 
.exre in your home directory. This file normally sets the user’s pre- 
ferred options so that they need not be set manually each time you 
invoke vi. Each of the options is described in detail below. 


Options 


There are only two kinds of options: switch options and string 
options. A switch option is either on or off. A switch is turned off 
by prefixing the word no to the name of the switch within a set 
command. String options are strings of characters that are assigned 
values with the syntax option=string. Multiple options may be 
specified on a line. Vi options are listed below: 


autoindent, ai default: noai 

Can be used to ease the preparation of structured program text. 
For each line created by an append, change, insert, open, or 
substitute operation, vi looks at the preceding line to determine 
and insert an appropriate amount of indentation. To back the 
cursor up to the preceding tab stop, press Ctrl-D. The tab stops 
going backward are defined as multiples of the shiftwidth 
option. You cannot backspace over the indent, except by press- 
ing Ctrl-D. 


Specially processed in this mode is a line with no characters 
added to it, which turns into a completely blank line (the whi- 
tespace provided for the autoindent is discarded). Also, spe- 
cially processed in this mode are lines beginning with a caret (“) 
and immediately followed by a Ctrl-D. This causes the input to 
be repositioned at the beginning of the line, but retains the pre- 
vious indent for the next line. Similarly, a ‘‘O” followed by a 
Ctrl-D, repositions the cursor at the beginning without retaining 
the previous indent. Autoindent doesn’t happen in global com- 
mands. 


autoprint ap default: ap 
Causes the current line to be displayed after each ex copy, 
move, or substitute command. This has the same effect as sup- 
plying a trailing “p” to each such command. Autoprint is 
suppressed in globals, and only applies to the last command on 
a line. 
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autowrite, aw default: noaw 
Causes the contents of the buffer to be automatically wmtten to 
the current file if you have modified it when you give a next, 
rewind, tag, or ! command, or a Ctrl-- (switch files) or Ctrl-] (tag 
go to) command. 


beautify, bf default: nobeautify 
Causes all control characters except tab, newline and formfeed 
to be discarded from the input. A complaint is registered the 
first time a backspace character is discarded. Beautify does not 
apply to command input. 


directory, dir default: dir=/tmp 
Specifies the directory in which wi places the editing buffer file. 
If the directory does not have write permission, the editor will 
exit abruptly when it fails to write to the buffer file. 


edcompatible default: noedcompatible 
Causes the presence or absence of g and ¢ suffixes on substitute 
commands to be remembered, and to be toggled on and off by 
repeating the suffixes. The suffix r causes the substitution to be 
like the tilde (~) command, instead of like the ampersand com- 
mand (&). 


errorbells, eb default: noeb 
Error messages are preceded by a bell. If possible, the editor 
always places the error message in inverse video instead of ring- 
ing the bell. 


hardtabs, ht default: ht=8 
Gives the boundaries on which terminal hardware tabs are set or 
on which tabs the system expands. 


ignorecase, ic default: noic 
Maps all uppercase characters in the text to lowercase in regular 
expression matching. In addition, all uppercase characters in 
regular expressions are mapped to lowercase except in character 
class specifications enclosed in brackets. 


lisp default: nolisp 
Autoindent indents appropriately for LISP code, and the () { } 
[{ and ]] commands are modified to have meaning for LISP. 


list default: nolist 
All printed lines are displayed,, showing tabs and end-of-lines. 


magic default: magic 
If nomagic is set, the number of regular expression metacharac- 
ters is greatly reduced, with only up-arrow (*) and dollar sign ($) 
having special effects. In addition, the metacharacters “~” and 
‘“&”? in replacement patterns are treated as normal characters. 
All the normal metacharacters may be made magic when 
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nomagic is set by preceding them with a backslash (\). 


mesg default: nomesg 
Causes write permission to be turned off to the terminal while 
you are in visual mode, if nomesg is set. This prevents people 
writing to your screen with the XENIX write command and 
scrambling your screen as you edit. 


number, n default: nonumber 
Causes all output lines to be printed with their line numbers. 


open default: open 
If set to noopen, the commands open and visual are not permit- 
ted from ex. This is set to prevent confusion resulting from 
accidental entry to open or visual mode. 


optimize, opt default: optimize 
Output of text to the screen is expedited by setting the terminal 
so that it does not perform automatic carriage returns when 
displaying more than one line of output, thus greatly speeding 
output on terminals without addressable cursors when text with 
leading whitespace is printed. 


paragraphs, para default: para=IPLPPPOPP TPbp 
Specifies paragraph delimiters for the { and } operations. The 
pairs of characters in the option’s value are the names of the 
nroff macros that start paragraphs. 


prompt default: prompt 
Ex input is prompted for with a colon (:). If noprompt is set, 
when ex command mode is entered with the Q command, no 
colon prompt is displayed on the status line. 


redraw default: noredraw 
The editor simulates (using great amounts of output), an intelli- 
gent terminal on a dumb terminal. Useful only at very high 
speed. 


remap default: remap 
If on, mapped characters are repeatedly tried until they are 
unchanged. For example, if o is mapped to O and O is mapped 
to I, o will map to J if remap is set, and to O if noremap is set. 


report default: report=5 

Specifies a threshold for feedback from commands. Any com- 
mand that modifies more than the specified number of lines will 
provide feedback as to the scope of its changes. For global 
commands and the undo command, the net change in the 
number of lines in the buffer is presented at the end of the com- 
mand. Thus notification is suppressed during a g command on 
the individual commands performed. 
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scroll default: scrol='2 window 
Determines the number of logical lines scrolled when Ctrl-D is 
received from a terminal input in command mode, and the 
number of lines displayed by a command mode z command 
(double the value of scroll). 


sections default: sections=SHNHH HU 
Specifies the section macros for the [[ and ]] operations. The 
pairs of characters in the option’s value are the names of the 
nroff macros that start paragraphs. 


shell, sh default: sh=/bin/sh 
Gives the pathname of the shell forked for the shell escape 
command (!), and by the shell command. The default is taken 
from SHELL in the environment, if present. 


shiftwidth, sw default:sw=8 
Gives the width of a software tab stop, used in reverse tabbing 
with Ctrl-D when using autoindent to append text, and by the 
shift commands. | 


showmatch, sm default: nosm 
When a ) or } is typed, moves the cursor to the matching ( or { 
for one second if this matching character is on the screen. 


tabstop, ts default: ts=8 
The editor expands tabs in the input file to be on n boundaries 
for the purposes of display. 


taglength, tl default: tl=O 
The first 1 characters in a tag name are significant, but all others 
are ignored. A value of zero (the default) means that all charac- 
ters are significant. 


tags default: tags=tags /usr/lib/tags 
A path of files to be used as tag files for the tag command. A 
requested tag is searched for in the specified files, sequentially. 
By default, files named tag are searched for in the current direc- 
tory and in /usr/lib. 


term default=value of shell TERM vanable 
The terminal type of the output device. 


terse default: noterse 
Shorter error diagnostics are produced for the experienced user. 


warn default: warm 


Warn if there has been “[No write since last change]” before a 
shell escape command (!). 
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window default: window = speed dependent 
This specifies the number of lines in a text window. The default 
is 8 at slow speeds (600 baud or less), 16 at medium speed (1200 
baud), and the full screen (minus one line) at higher speeds. 


w300, w1200, w9600 
These are not true options but set window (above) only if the 
speed is slow (300), medium (1200), or high (9600), respectively. 


wrapscan, ws default: ws 
Searches, using the regular expressions in addressing, will wrap 
around past the end of the file. 


wrapmargin, wm default: wm=0 
Defines the margin for automatic insertion of newlines during 
text input. A value of zero specifies no wrap margin. 


writeany, wa default: nowa 
Inhibits the checks normally made before write commands, 
allowing a write to any file that the system protection mechanism 
will allow. 


Regular Expressions 


A regular expression specifies a set of strings of characters. A 
member of this set of strings is said to be by the regular expression. 
Vi remembers two previous regular expressions: the previous regular 
expression used in a substitute command and the previous regular 
expression used elsewhere, referred to as the previous scanning reg- 
ular expression. The previous regular expression can always be 
referred to by a null regular expression: e.g., “//” or ats ee 


The regular expressions allowed by wi are constructed in one of two 
ways depending on the setting of the magic option. The ex and wi 
default setting of magic gives quick access to a powerful set of regu- 
lar expression metacharacters. The disadvantage of magic is that 
the user must remember that these metacharacters are magic and 
precede them with the backslash (\) to use them as “ordinary” 
characters. With nomagic set, regular expressions are much 
simpler, there being only two metacharacters. The power of the 
other metacharacters is still available by preceding the now ordinary 
character with a “\’. Note that “\’ is always a metacharacter. In 
this discussion, the magic option is assumed. With nomagic , the 
only special characters are the caret (*) at the beginning of a regular 
expression, the dollar sign ($) at the end of a regular expression, 
and the backslash (\). The tilde (~) and the ampersand (&) also 
lose their special meanings related to the replacement pattern of a 
substitute. 
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The following basic constructs are used to construct magic mode 
regular expressions. 


char An ordinary character matches itself. Ordinary characters are 
any characters except a caret (“) at the beginning of a line, a 
dollar sign ($) at the end of line, a star (*) as any character 
other than the first, and any of the following characters: 


a 


These characters must be preceded by a backslash (\) if they 
are to be treated as ordinary characters. 


At the beginning of a pattern, forces the match to succeed 
only at the beginning of a line. 


$ At the end of a regular expression, forces the match to 
succeed only at the end of the line. 


Matches any single character except the newline character. 


\< Forces the match to occur only at the beginning of a “‘word’’; 
that is, either at the beginning of a line, or just before a letter, 
digit, or underline and after a character not one of these. 


\> Similar to “\<”, but matching the end of a “word”, i.e., 
either the end of the line or before a character which is not a 
letter, a digit, or the underline character. 


[string] 

Matches any single character in the class defined by String. 
Most characters in string define themselves. A pair of charac- 
ters separated by a dash (-—) in string defines the set of charac- 
ters between the specified lower and upper bounds, thus 
‘“la-z] as a regular expression matches any single lowercase 
letter. If the first character of string is a caret (~) then the 
construct matches those characters which it otherwise would 
not. Thus ‘{*a-z]” matches anything but a lowercase letter or 
a newline. To place any of the characters caret, left bracket, 
or dash in String they must be escaped with a preceding 
backslash (\). 


The concatenation of two regular expressions first matches the left- 
most regular expression and then the longest string that can be 
recognized as a regular expression. The first part of this new regu- 
lar expression matches the first regular expression and the second 
part matches the second. Any of the single character matching reg- 
ular expressions mentioned above may be followed by a star () to 
form a regular expression that matches zero or more adjacent 
occurrences of the characters matched by the prefixing regular 
expression. The tilde (() may be used in a regular expression to 
match the text that defined the replacement part of the last s 
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command. A regular expression may be enclosed between the 
sequences “\(” and ‘“‘\)” to remember the text matched by the 
enclosed regular expression. This text can later be interpolated into 
the replacement text using the following notation: 


\digit 
where digit enumerates the set of remembered regular expressions. 


The basic metacharacters for the replacement pattern are the 
ampersand (&) and the tilde (~); these are given as Ver and °V" 
when nomagic is set. Each instance of the ampersand is replaced 
by the characters matched by the regular expression. In the 
replacement pattern, the tilde stands for the text of the previous 
replacement pattern. 


Other metasequences possible in the replacement pattern are always 
introduced by a backslash (\). The sequence “\w” is replaced by 
the text matched by the mth regular subexpression enclosed between 
“\(’? and “\)”. When nested, parenthesized subexpressions are 
present, n is determined by counting occurrences of “\(? starting 
from the left. The sequences ‘‘\u” and “\” cause the immediately 
following character in the replacement to be converted to upper- 
case or lowercase, respectively, if this character is a letter. The 
sequences “\U” and “\L” turn such conversion on, either until 
gal Say or “\e” is encountered, or until the end of the replacement 
pattern. 
Limitations 

When using vi, you should note the following limits: 

250K lines in a file 

510 characters per line 

256 characters per global command list 

128 characters per filename 

128 characters in the previous inserted and deleted text 

100 characters in a shell escape command 


63 characters in a string valued option 


30 characters in a tag name 
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Credit 


-_ This utility was developed at the University of California at 
Berkeley and is used with permission. 


Notes 


The /usr /lib / ex3. 7preserve program can be used to restore vi buffer 
files that were lost as a result of a system crash. The program 
searches the /tmp directory for wi buffer files and places them in 
the directory /usr/preserve. The owner can retrieve these files 
using the —r option. 


The / usr/lib / ex3.7preserve program must be placed in the system 
startup file, /etc/re, before the command that cleans out the /tmp 
directory. See the XENIX Operations Guide for more information 
on /etc/re. 
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Name 


vsh — menu driven visual shell 


Syntax 


vsh 


Description 


Vsh is a highly interactive, visually oriented shell which eases many 
XENIX activities. The vsh features both standard and customizable 
XENIX command menus and on-line help. The vsh displays infor- 
mation and menus in windows on the screen. To enter vsh, simply 
enter: 


vsh 


from a shell prompt. Vsh can also be made a user’s default shell by 
changing their shell entry in /etc/passwd (the last colon—separated 
field). Help is available from all menus by typing the question 
mark character. 


The very last line of the screen is a status line. The status line 
displays the current pathname, the date, time and operating system 
name. If you have new mail, the status line will indicate so. 
Above the status line is the message line, which displays messages, 
error or otherwise, from vsh. 


A command menu is displayed at the bottom of the screen. The 
standard menu contains a range of commonly used XENIX com- 
mands. Above the command menu is the output window. This 
window contains a scrolling display of the output from commands. 
This window is not visible at start-up, but is displayed while run- 
ning certain commands such as ‘=’. 


In the top of the screen is a window with a listing of the current 
working directory. To alter the size of this window, use the 
Window command from the main command menu. Items in the 
listing window may be selected using standard key commands 
(q.v.). Two special key commands are used with the listing win- 
dow. The equals sign ‘=’ (SHOW?) key, displays the contents of 
the currently selected file or directory. The minus sign ‘—’ (GOA- 
WAY’) key, returns you to the listing window. 
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Commands may be invoked in one of two ways. A command can 
be selected by pressing the first letter of its name. Alternatively, 
press the space bar. Each time the space bar is pressed, the next 
menu item is highlighted. This highlighting indicates that the com— 
mand has been selected. Backspace moves to the previous selec— 
tion. 


Once a command is selected, press the return key. A menu is 
displayed which gives the valid arguments for the particular com- 
mand. The default choice is shown in parentheses, e.g.: 


recursive: Yes (No) 


To send the output to another program, you may enter a vertical 
bar in the “‘output:” field of the commands’ menu. 


When the menu is filled in, press RETURN to start the command. 


Main Menu Commands 


The following menu options are available from the standard main 
menu. Certain sub-commands are available under the Options 
selection. These are described in the next section. 


Copy 
Copy a file to a new file. Copy the contents of a directory to a 
new directory. 


Delete 
Delete a file or directory. 


Edit 
Invoke an editor for a file. Default is the visual editor vi(C). 


Help 
Get help on diverse topics. A menu is displayed at the bottom 
of the screen of available help topics. 


Mail 
Send or read XENIX mail. 


Name 
Rename a directory or file. 


Options 
Perform various commands. See OPTIONS section. 


Print 
Print file or files on systems’ lineprinter. 
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Quit 
Quit the visual shell. 


Run 
Run a specified XENIX command or applications program. 


View 7 
View a specified file or directory listing. This file or directory 
listing will be displayed in the upper window. Use the vsh scrol- 


ling commands to move around (see KEY COMMANDS Sec- 
tion). 


Window 
Reset upper window ‘redraw’ characteristics and height. 


Options Subcommand 


The Options selection on the main menu has several important 
commands grouped under the selections Directory, Filesystem, 
Output, and Permissions. These are as follows: 


Directory 


Make 
Make a directory under current working directory. 


Usage 


Display disk usage by number of blocks in current working 
directory. 


Filesys tem 


Create 
Create a filesystem. 


FilesCheck 
Check file system consistency. 


Mount 
Mount a file system on a specified mount-—point. 


SpaceFree 
Report number of disk blocks available on all or some mounted 
file systems. 


Unmount 
Unmount specified file system if it is not currently busy. 
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Output 


VShell 
Echo vsh commands in output window (default). 


XENIX 
Echo actual XENIX commands in output window. For 
instance, if running “Options Filesystem FilesCheck”’, the com— 
mand fsck will be displayed in the output window if “Options 
Output Xenix” is set. 


Permissions 


Change permissions on a file or directory. 


Key Commands 


The following keyboard commands allow editing of menus and 
fields, and give access to various vsh features. 


—Cin-E> 
Move the cursor up one line. 


<Ctrl-X> 
Move the cursor down one line. 


<Ctrl-S> 
Move the cursor left one character. 


<Ciri-D> 
Move the cursor right one character. 


<Ctrl-R> <Ctrl-E> 
Scroll page up. 


<Ctrl-R> <Ctrl-X> 
Scroll page down. 


<CtrlI-R><Ctrl-S> 
Scroll page left. 


<Ctrl-R><Ctrl-D> 
Scroll page right. 


<Ctrl-Q> 
Home. Go to start of menu. 
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<Ctrl-Z> 
End. Go to the end of menu. 


<Col-C> 
Cancel. Stop present operation and return to the main com-— 
mand menu. 


<RETURN> 
Start the present command. 


<TAB>, <Ctrl-I>, or <Ctrl-A> 
Move to and select entire contents of next field in command 
line. 


<SPACE> 
Select next item in menu. 


<BACKSPACE> or <Ctrl-H> 
Select previous menu item. In editing command lists, deletes 
character. Replacement text may then be typed. 


<Ctrl-Y> or <DEL> 
Delete selected character. 


og sy 
Move to next character to right of current cursor position. 


<Ctri-K> 
Move to next character to left of current cursor position. 


<Ctrl-P> 
Move to next word to right of current cursor position. 


<Ctl-O> 
Move to next word to left of current cursor position. 


? Help. Request information about the selected command or 
command in progress at the time of the request. 


= Show. Display sub-directory listings and text files in directory 
listings. Display submenus for commands in main menu. 


— Goaway. Return listing window to current or parent directory 
after a show command. 


@ Display the Modify menu. 
! Redraw the screen. 


| Display filter menu. 
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Files 
menu.def 


.mnu 


/usr/lib/vsh/ VSHELL.HPP 


/usr/lib/vsh/ VSHELL.HPT 
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standard menu definition file. 
extension for customized command 
menus. 


help file 


yet another help file 
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Name 


wait — Awaits completion of background processes. 


Syntax 


wait 


Description 


Waits until all background processes started with an ampersand (&) 
have finished, and reports on abnormal terminations. 


Because the wait(S) system call must be executed in the parent pro- 
cess, the shell itself executes wait, without creating a new process. 


See Also 


sh(C) 
Notes 


Not all the processes of a pipeline with three or more stages are 
children of the shell, and thus cannot be waited for. 
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Name 


wall — Writes to all users. 


Syntax 


/etc/wall 


Description 
Wall reads a message from the standard input until an end-of-file. 
It then sends this message to all users currently logged in preceded 
by “Broadcast Message from ...”. Wall is used to warn all users, 
for example, prior to shutting down the system. 
The sender should be super-user to override any protections the 
users may have invoked. 


Files 


/dev/tty* 


See Also 


mesg(C), write(C) 


Diagnostics 


Cannot send to ... The open on a user’s tty file has failed. 
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Name 


wc — Counts lines, words and characters. 


Syntax 


: we [ —lwe | [ names | 


Description 


Wc counts lines, words and characters in the named files, or in the 
standard input if no names appear. It also keeps a total count for 
all named files. A word is a maximal string of characters delimited 


by spaces, tabs, or newlines. 

The options I], w, and c may be used in any combination to specify 
that a subset of lines, words, and characters are to be reported. 
The default is —lwe. 


When names are specified on the command line, they are printed 
along with the counts. 
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Name 


what — Identifies files. 


Syntax 


what files 


Description 

What searches the given files for all occurrences of the pattern 
@(#) and prints out what follows until the first tilde (~), greater- 
than sign (>), new-line, backslash (\) or null character. The 
SCCS command get(CP) substitutes this string as part of the @(#) 
string. 
For example, if the shell procedure in file print contains 

# @(#)this is the print program 

# eens print [files] 

pr $* | lpr 
then the command 


what print 


displays the name of the file print and the identifying strings in that 
file: 


print: 
this is the print program 
syntax: print [files] 
What is intended to be used with the get(CP) command, which 


automatically inserts identifying information, but it can also be used 
where the information is inserted manually. 


See Also 
admin(CP), get(CP) 
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Name 


who — Lists who is on the system. 


Syntax 
who [| —uTHldbrtasgq | [ file ] 
who am i | 


who am I 


Description 


Who can list the user’s name, terminal line, login time, and the 
elapsed time since activity occurred on the line; it also lists the pro- 
cess ID of the command interpreter (shell) for each current XENIX 
system user. It examines the /etc/utmp file to obtain its informa- 
tion. If file is given, that file is examined. Usually, file will be 
/etc/wtmp, which contains a history of all the logins since the file 
was last created. 


Who with the am i or am I option identifies the invoking user. 


Except for the default —s option, the general format for output 
entries is: 


name [state] line time activity pid [comment] [exit] 


With options, who can list logins, logoffs, reboots, and changes to 
the system clock, as well as other processes spawned by the init 
process. These options are: 


-—u =‘ This option lists only those users who are currently logged in. 
The name is the user’s login name. The line is the name of 
the line as found in the directory /dev. The time is the time 
that the user logged in. The activity is the number of hours 
and minutes since activity last occurred on that particular 
line. A dot (.) indicates that the terminal has seen activity 
in the last minute and is therefore ‘“‘current”. If more than 
twenty-four hours have elapsed or the line has not been used 
since boot time, the entry is marked old. This field is useful 
when trying to determine whether a person is working at the 
terminal or not. The pid is the process ID of the user’s shell. 
The comment is the comment field. It can contain informa- 
tion about where the terminal is located, the telephone 
number of the dataset, the type of terminal if hard-wired, 
etc. 
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-~T 


oad | 


at 


=~ 


Files 


This option is the same as the —u option, except that the 
state of the terminal line is printed. The state describes 
whether someone else can write to that terminal. A plus 
character (+) appears if the terminal is writable by anyone; a 
minus character (—) appears if it is not. Root can write to 
all lines having a plus character (+) or a minus character (—) 
in the state field. If a bad line is encountered, a question 
mark (?) is displayed. 


This option lists only those lines on which the system is wait- 
ing for someone to login. The name field is LOGIN in such 
cases. Other fields are the same as for user entries except 
that the state field does not exist. 


This option displays column headings above the regular out- 
put. 


This is a quick who, displaying only the names and the 
number of users currently logged on. When this option is 
used, all other options are ignored. 


This option displays all processes that have expired and have 
not been respawned by init. The exit field appears for dead 
processes and contains the termination and exit values (as 
returned by wait(S)), of the dead process. This can be use- 
ful in determining why a process terminated. 


This option indicates the time and date of the last reboot. 
This option indicates the current run-level of the init process. 


This option indicates the last change to the system clock (via 
the date(C) command) by root. See su(C). 


This option processes the /etc/utmp file or the named file 
with all options turned on. 


This option is the default and lists only the name, line, and 
time fields. 


/etc/utmp 
/etc/wtmp 


See Also 


date(C), login(C), mesg(C), su(C), utmp(F), wait(S) 
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Name 


whodo — Determines who 1s doing what. 


Syntax 
/etc/whodo 
Description 
Whodo produces merged, reformatted, and dated output from the 


who(C) and ps(C) commands. 


See Also 


ps(C), who(C) 
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Name 


write — Writes to another user. 


Syntax 


write user [| tty | 


Description 


Write copies lines from your terminal to that of another user. 
When first called, it sends the message: 


Message from your-logname your-tty ... 


The recipient of the message should write back at this point. Com- 
munication continues until an end-of-file is read from the terminal 
or an interrupt is sent. At that point, write displays: 


(end of message) 
on the other terminal and exits. 


If you want to write to a user who is logged in more than once, the 
tty argument may be used to indicate the appropriate terminal. 


Permission to write may be denied or granted by use of the mesg(C) 
command. At the outset, writing is allowed. Certain commands, 
in particular nroff(CT) and pr(C), disallow messages in order to 
prevent messy output. 


If the character ! is found at the beginning of a line, write calls the 
shell to execute the rest of the line as a command. 


The following protocol is suggested for using write: when you first 
write to another user, wait for him or her to write back before start- 
ing to send. Each party should end each message with a distinctive 
signal ((0) for “over” is conventional), indicating that the other 
may reply; (oo) for ‘over and out” is suggested when conversation 
is to be terminated. 
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Files 
/etc/utmp To find user 
/bin/sh To execute ! 
See Also 


mail(C), mesg(C), who(C) 
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Name 


xargs — Constructs and executes commands. 


Syntax 


xargs [ flags ] [ command [ initial-arguments ] ] 


Description 


Xargs combines the fixed initial-arguments with arguments read 
from the standard input to execute the specified command one or 
more times. The number of arguments read for each command 
invocation and the manner in which they are combined are deter- 
mined by the flags specified. 


Command, which may be a shell file, is searched for using the shell 
$PATH variable. If command is omitted, /bin/echo is used. 


Arguments read in from standard input are defined to be contigu- 
ous strings of characters delimited by one or more blanks, tabs, or 
newlines; empty lines are always discarded. Blanks and tabs may 
be embedded as part of an argument if escaped or quoted: Charac- 
ters enclosed in quotes (single or double) are taken literally, and 
the delimiting quotes are removed. Outside of quoted Strings, a 
backslash (\) will escape the next character. 


Each argument list is constructed starting with the initial-arguments , 
followed by some number of arguments read from standard input 
(exception: see —i flag). Flags —i, —1, and —n determine how argu- 
ments are selected for each command invocation. When none of 
these flags are coded, the initial-arguments are followed by argu- 
ments read continuously from standard input until an internal 
buffer is full, and command is executed with the accumulated args. 
This process is repeated until there are no more args. When there 
are flag conflicts (e.g., —-l vs. —mn), the last flag has precedence. 
Flag values are: 


—Inumber Command is executed for each number lines of 
nonempty arguments from the standard input. This is 
instead of the default single line of input for each 
command. The last invocation of command will be 
with fewer lines of arguments if fewer than number 
remain. A line is considered to end with the first new- 
line unless the last character of the line is a blank or a 
tab; a trailing blank/tab signals continuation through 
the next nonempty line. If number is omitted, 1 is 
assumed. Option —x is forced. 
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—ireplstr 


—nnumber 


aa 


—p 


“a 


—SSIZE 


—eeofstr 
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Insert mode: command is executed for each line from 
the standard input, taking the entire line as a single 
arg, inserting it in  initial-arguments tor each 
occurrence of replstr. A maximum of 5 arguments in 
initial-arguments may each contain one or more 
instances of replstr. Blanks and tabs at the beginning 
of each line are thrown away. Constructed arguments 
may not grow larger than 255 characters, and option 
—x is also forced. {} is assumed for replstr if not 
specified. 


Executes command , using as many standard input 
arguments as possible, up to the number of arguments 
maximum. Fewer arguments are used if their total size 
is greater than size characters, and for the last invoca- 
tion if there are fewer than number arguments remain- 
ing. If option —x is also coded, each number of argu- 
ments must fit in the size limitation, or xargs ter- 
minates execution. 


Trace mode: The command and each constructed 
argument list are echoed to file descriptor 2 just prior 
to their execution. 


Prompt mode: The user is prompted whether to exe- 
cute command at each invocation. Trace mode (—f) is 
turned on to display the command instance to be exe- 
cuted, followed by a ?... prompt. A reply of y 
(optionally followed by anything), will execute the 
command; anything else, including a carriage return, 
skips that particular invocation of command. 


Causes xargs to terminate if any argument list would 
be greater than size characters; —x is forced by the 
options —i and —l. When neither of the options —i, 
—l, or —n are coded, the total length of all arguments 
must be within the size limit. 


The maximum total size of each argument list is set to 
size characters; size must be a positive integer less 
than or equal to 470. If —s is not coded, 470 is taken 
as the default. Note that the character count for size 
‘ncludes one extra character for each argument and 
the count of characters in the command name. 


Eofstr is taken as the logical end-of-file string. Under- 
score (_) is assumed for the logical EOF string if —e is 
not coded. —e with no eofstr coded turns off the logi- 
cal EOF string capability (underscore is taken literally). 
Xargs reads standard input until either end-of-file or 
the logical EOF string is encountered. 
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Xargs terminates if it either receives a return code of —1 from, or 
if it cannot execute, command. When command is a shell pro- 
gram, it should explicitly exit (see sh(C)) with an appropriate value 
to avoid accidentally returning with —1. 


Examples 


The following will move all files from directory $1 to directory $2, 
and echo each move command just before doing it: 


Is $1 | xargs -i -t mv $1/{} $2/{} 


The following will combine the output of the parenthesized com- 
mands onto one line, which is then echoed to the end of file log: 


(logname; date; echo $0 $*) | xargs >>log 


The user is prompted to enter which files in the current directory 
are to be printed and prints them one at a time: 


ls | xargs —p -1 Ipr 
Or many at a time: 
Is | xargs —p -1 | xargs Ipr 


The following will execute diff(C) with successive pairs of argu- 
ments originally entered as shell arguments: 


echo $* | xargs —-n2 diff 
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Name 


yes — Prints string repeatedly. 


Syntax 


yes | string | 


Description 


Yes repeatedly outputs “‘y’, or if a single string argument is given, 
arg is output repeatedly. The command will continue indefinitely 
unless aborted. Useful in pipes to commands that prompt for input 
and require a “‘y” response for a yes. In this case, yes terminates 
when the command it pipes to terminates, so that no infinite loop 
occurs. 
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? 
Name 


termcap — Terminal capability data base. 


Description 


The file /etc/termcap is a data base describing terminals. This data 
base is used by commands such as wi(C), vsh(C), Lyrix, Multiplan 
and sub-routine packages such as curses(S). Terminals are 
described in termcap by giving a set of capabilities and by describ- 
ing how operations are performed. Padding requirements and ini- 
tialization sequences are included in termcap. 


Entries in fermcap consist of a number of ‘:’ separated fields. The 
first entry for each terminal gives the names which are known for 
the terminal, separated by vertical bar (| ) characters. The first 
name is always 2 characters long for compatibility with older sys- 
tems. The second name given is the most common abbreviation 
for the terminal and the name used by vi and ex(C). The last name 
given should be a long name fully identifying the terminal. Only the 
last name may contain blanks for readability. 


Capabilities (including XENIX Extensions) 


The following is a list of the capabilities that can be defined for a 
given terminal. In this list, (P) indicates padding may be specified, 
and (P*) indicates that padding may be based on the number of 
lines affected. The capability type and padding fields are described 
in detail in the following section “Types of Capabilities.” 


The codes beginning with uppercase letters (except for CC) indicate 
XENIX extensions. They are included in addition to the standard 
entries and are used by one or more application programs. As with 
the standard entries, not all modes are supported by all applications 
or terminals. Some of these entries refer to specific terminal out- 
put capabilities (such as GS for graphics start). Others describe 
character sequences sent by keys that appear on a keyboard (such 
as PU for PageUp key). There are also entries which are used to 
attribute special meanings to other keys (or combinations of keys) 
for use in a particular software program. Some of the XENIX 
extension capabilities have a similar function to standard capabili- 
ties. They are used to redefine specific keys (such as using function 
keys as arrow keys). The extension capabilities are included in the 
/etc/termcap file as they are required for some XENIX utilities 
(such as vsh(C)). The more commonly used extension capabilities 
are described in more detail in the section ““XENIX Extensions.” 
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Name Type Pad? Description 


ae str (P)_ End alternate character set 

al str (P*) Add new blank line 

am bool Terminal has automatic margins 

as str (P) Start alternate character set 

be str Backspace if not “H 

bs bool Terminal can backspace with “H 

bt str (P) Back tab 

bw __ bool Backspace wraps from column 0 
to last column 

CC ° str Command character in prototype 


if terminal settable 

cd str (P*) Clear to end of display 

ce str (P) Clear to end of line 

CF _ str Cursor off 

ch str (P) Like cm but horizontal motion only, 
line stays same 


Cl str Sent by CHAR LEFT key 
cl str (P*) Clear screen 

cm str (P) Cursor motion 

co num Number of columns in a line 
CO - str Cursor on 


cr str (P*) Carriage return, (default “M) 
cs str (P) Change scrolling region (vt100), like cm 
CV str (P) Like ch but vertical only. 


CW str Sent by CHANGE WINDOW key 
da bool Display may be retained above 
DA bool Delete attribute string 
db bool Display may be retained below 
dB num Number of millisec of bs delay needed 
dC num Number of millisec of cr delay needed 
dc str (P*) Delete character 
dF num Number of millisec of ff delay needed 
dl str (P*) Delete line 
dm str Delete mode (enter) 
dN num Number of millisec of nl delay needed 
do str Down one line 
dT num Number of millisec of tab delay needed 
ed str End delete mode 
el str End insert mode; give *:ei=* 
if ic 
EN _ str Sent by END key 
Te) bool Can erase overstrikes with a blank 
ff str (P*) Hardcopy terminal page eject (default “L) 
G1 _ str Upper-right (1st quadrant) corner character 
G2 _ str Upper-left (2nd quadrant) corner character 
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Name Type Pad? Description 


G3 str Lower-left (3rd quadrant) corner character 
G4 str Lower-right (4th quadrant) corner character 
GC _ str Center graphics character (similar to “‘+’’) 
GD - str Down-tick character 

GE str Graphics mode end 

GG num Number of chars taken by GS and GE 
GH _- str Horizontal bar character 

GL _ str Left—tick character 

GR - str Right—tick character 

GS _ str Graphics mode start 

GU _ str Up-tick character 

GV _ str Vertical bar character 

he bool Hardcopy terminal 

hd str Half-line down (forward 1/2 linefeed) 
HM - str Sent by HOME key (if not kh) 

ho str Home cursor (if no cm) 

hu str Half-line up (reverse 1/2 linefeed) 

hz str Hazeltine; can’t print ~’s | 

ic str (P) Insert character 

if str Name of file containing is 

im str Insert mode (enter); give ‘:im=’ if ic 

in bool Insert mode distinguishes nulls on display 
ip str (P*) Insert pad after character inserted 

1S str Terminal initialization string 

k0-k9 str Sent by ‘other’ function keys 0-9 

kb str Sent by backspace key 

kd str Sent by terminal down arrow key 

ke str Out of ‘keypad transmit’ mode 

kh str Sent by home key 

kl str Sent by terminal left arrow key 

kn num Number of ‘other’ keys 

ko str Termcap entries for other non-function keys 
kr str Sent by terminal right arrow key 

ks str Put terminal in ‘keypad transmit’ mode 
ku str Sent by terminal up arrow key 

10-19 str Labels on ‘other’ function keys 

LD ~ str Sent by line delete key 

LF _ str Sent by line feed key 

li num Number of lines on screen or page 

ll str Last line, first column (if no em) 

ma ___ str Arrow key map, used by vi version 2 only 
mi bool Safe to move while in insert mode 

ml str Memory lock on above cursor 

MP - str Multiplan initialization string 

MR - str Multiplan reset string 

ms bool Will scroll in stand—out mode 

mu __ str Memory unlock (turn off memory lock) 
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Name Type Pad? Description 


nc 


nd 
nl 
ns 
NU 
Os 
pc 
PD 


pt 


PU 
RC 
RF 
RT 
se 
sf 
Sg 
SO 
sr 
ta 
ic 
te 
ti 
uc 
ue 
ug 
ul 


up 
UP 
us 
vb 
ve 
VS 
WL 
WR 
xb 


XT 
pet 


XS 
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bool 


str 
str 
bool 
str 
bool 
str 
str 
bool 


str 
str 
str 
str 
str 
str 
num 
str 
str 
str 
str 
str 
str 
str 
str 
num 
bool 


str 
str 
str 
str 
str 
str 
str 
str 
bool 
bool 


bool 
bool 


bool 


(P*) 


(P) 


(P) 
(P) 


No correctly working carriage return 
(D M2500, H2000) 

Non-destructive space (cursor right) 
Newline character (default \n) 
Terminal is a CRT but doesn’t scroll 
Sent by NEXT UNLOCKED CELL key 
Terminal overstrikes 

Pad character (rather than null) 
Sent by PAGE DOWN key 

Has hardware tabs 

(may need to be set with is) 


- Sent by PAGE UP key 


Sent by RECALC key 

Sent by TOGGLE REFERENCE key 
Sent by RETURN key 

End stand out mode 

Scroll forwards 

Number of blank chars left by so or se 
Begin stand out mode 

Scroll reverse (backwards) 

Tab (other than “I or with padding) 
Entry of similar terminal - must be last 
String to end programs that use cm 
String to begin programs that use cm 
Underscore one char and move past it 
End underscore mode 

Number of blank chars left by us or ue 
Terminal underlines even though 

it doesn’t overstrike 

Upline (cursor up) 

Sent by up—arrow key (alternate to ku) 
Start underscore mode 

Visible bell (may not move cursor) 
Sequence to end open/visual mode 
Sequence to start open/visual mode 
Sent by WORD LEFT key 

Sent by WORD RIGHT key 

Beehive (f1=escape, f2=ctrl C) 

A newline is ignored after a wrap 
(Concept) 

Return acts like ce \r \n 

(Delta Data) 

Standard out not erased by writing over it 
(HP 264?) 

Tabs are destructive, magic so char 
(Teleray 1061) 
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A Sample Entry 


The following entry describes the Concept-100, and is among the 
more complex entries in the termcap file. (This particular concept 
entry is outdated, and is used as an example only.) 


c1|c100| concept100:is=\EU\Ef\E7\E5\E8\El\ENH\EK\E\200\E0&\200:\ 
:al=3*\E°R:am:bs:cd=16*\E’C:ce=16\E’S:cl=2*°L:\ 
:;cm=\Ba%+ %+ :co#80:dc=16\E’A :dl=3*\E'B:\ 
:ei=\E\200:e0:im=\E’P::in:ip=16* li#24:mi:nd=\E=: 


:se=\Ed \Ee:so=\ED\EE:ta=8\t:ul:up=\E;:vb=\Ek\EK:xn: 


Entries may continue onto multiple lines by giving a \ as the last 
character of a line. Empty fields may be included for readability 
between the last field on a line and the first field on the next. 
Capabilities in termcap are of three types: Boolean capabilities, 
which indicate that the terminal has some particular feature, 
numeric capabilities giving the size of the terminal or the size of 
particular delays, and string capabilities, which give a sequence that 
can be used to perform particular terminal operations. 


Types of Capabilities 


All capabilities have two letter codes. For instance, the fact that 
the Concept has ‘automatic margins’ (i.e., an automatic return and 
linefeed when the end of a line is reached) is indicated by the capa- 
bility am. The description of the Concept includes am. Numeric 
capabilities are followed by the character ‘#’ and then the value. 
Thus co, which indicates the number of columns the terminal has, 
gives the value ‘80’ for the Concept. 
3 ; 

Finally, string valued capabilities, such as ce (clear to end of line 
sequence) are given by the two character code, an ‘=’, and then a 
string ending at the next following ‘:’. A delay in milliseconds may 
appear after the ‘=’ in such a capability, and padding characters are 
supplied by the editor after the remainder of the string is sent to 
provide this delay. The delay can be either a integer, e.g., ‘20’, or 
an integer followed by an ‘*’, i.e. ‘3*’. A ‘* indicates that the pad- 
ding required is proportional to the number of lines affected by the 
operation, and the amount given is the per-affected-unit padding 
required. When a ‘*’ is specified, it is sometimes useful to give a 
delay of the form ‘3.5’ to specify a delay per unit to tenths of mil- 
liseconds. 


A number of escape sequences are provided in the string valued 
capabilities for easy encoding of characters there. A \E maps to an 
ESCAPE character, “x maps to a control-x for any appropriate x, 
and the sequences \n \r \t \b \f give a newline, return, tab, back- 
space and formfeed. Finally, characters may be given as three octal 
digits after a \, and the characters * and \ may be given as \ and \\, 
If it is necessary to place a: in a capability, it must be escaped in 
octal as \072. If it is necessary to place a null character in a string 
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capability, it must be encoded as \200. The routines that deal with 
termcap use C strings, and strip the high bits of the output very late 
so that a \200 comes out as a \000 would. 


Preparing Descriptions 


We now outline how to prepare descriptions of terminals. The 
most effective way to prepare a terminal description is by imitating 
‘the description of a similar terminal in termcap and to build up a 
description gradually, using partial descriptions with ex to check 
that they are correct. Be aware that a very unusual terminal may 

~ expose deficiencies in the ability of the termcap file to describe it. 
To test a new terminal description, you can set the environment 
variable TERMCAP to a pathname of a file containing the descrip- 
tion you are working on and the editor will look there rather than 
in /etc/termcap. TERMCAP can also be set to the termcap entry 
itself to avoid reading the file when starting up the editor. 


Basic capabilities 


The number of columns on each line for the terminal is given by 
the co numeric capability. If the terminal is a CRT, the number of 
lines on the screen is given by the li capability. If the terminal 
wraps around to the beginning of the next line when it reaches the 
right margin, it should have the am capability. If the terminal can 
clear its screen, this is given by the el string capability. If the termi- 
nal can backspace, it should have the bs capability, unless a back- 
space is accomplished by a character other than “H in which case | 
you should give this character as the be string capability. If it over- 
strikes (rather than clearing a position when a character 1s struck 
over), it should have the os capability. . 


A very important point here is that the local cursor motions 
encoded in termcap are undefined at the left and top edges of a 
CRT terminal. The editor will never attempt to backspace around 
the left edge, nor will it attempt to go up locally off the top. The 
editor assumes that feeding off the bottom of the screen will cause 
the screen to scroll up, and the am capability tells whether the cur- 
sor sticks at the right edge of the screen. If the terminal has switch 
selectable automatic margins, the termcap file usually assumes that 
this is on (i.e., am). 


These capabilities suffice to describe hardcopy and ‘glass-tty’ termi- 
nals. Thus the model 33 teletype is described as 


t3| 33| tty33:co#72:0s 
while the Lear Siegler ADM-3 is described as 


cl | adm3|3|Isi adm3:am:bs:cl="Z:li#24:co#80 
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Cursor addressing 


Cursor addressing in the terminal is described by a em string capa- 
bility. This capability uses printf(S) like escapes (such as %x) in it. 
These substitute to encodings of the current line or column posi- 
tion, while other characters are passed through unchanged. If the 
cm string is thought of as being’a function, its arguments are the 
line and then the column to which motion iS desired, and the % 
encodings have the following meanings: ‘ y 


%o d replaced by tinefcoluinn position, o origin 

%o 2 like %2d-2 digit field 

%o3 like %3d - 3 digit field 

% like printf(S) %c ° °°"! 

%+x adds x to value, then %. 

%>xy if value > x adds y; no output. 

“oT reverses order of line and column, no output 

%o1 increments pegiconuman position (for 1 origin) 

%% gives a single % 

%oN exclusive or row and column with 0140 
(DM2500) 

%B BCD (16*(x/10)) + (x%10), no output. 

%D Reverse coding (x-2*(x%16)), no output. 
(Delta Data). 


Consider: the HP2645, which, to get to row 3 and column 12, needs 
to be sent \E&al2c03Y padded for 6 milliseconds. Note that the 
order of the rows'’and columns is' inverted here, and that the row 
and column~ dre ‘printed ‘as two digits. Thus its em capability is 
‘cm=6\E&%r%2c%2Y’. ‘The'Microterm ACT-IV'needs the current 
row and column:sent preceded by"a“F) with the row and column 
simply encoded in binary, ‘cm="T%.%.’. Terminals which use ‘%.’ 
need to be able to backspace the cursor (bs or be), and to move 
the cursor up one line on the scréen (up introduced below). This 
is necessary because it is not always safe to transmit \t, \n “D and 
\r, as the system may change or discard them. 


A final example is the LSI ADM-3a, which uses row and column 
offset by a blank character, thus ‘cm=\E=%+ %+ ’. 


Cursor motions 


If the terminal can move the cursor one position‘to the right, leav- 
ing the character at the current position unchanged, this sequence 
should be given as nd (non-destructive space). If it can move the 
cursor up a line on the screen in the same column, it should be 
given as up. If the terminal has no cursor addressing capability, 
but can home the cursor (to very upper left:corner of screen), this 
can be given as ho; similarly, a fast way of getting to the lower left 
hand corner can be given as ll; this may involve going up with up 
from the home position, but the editor will never do this itself 
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(unless ll does) because it makes no assumption about the effect of 
-. moving up from the home position. 


Area clears 


If the terminal can clear from the current position to the end of the 

line, leaving the cursor where it is, the sequence should be given as 

ce. If the terminal can clear from the current position to the end 

. Of the display, the sequence should be given as cd. The editor only 
uses ¢d from the first column of a line. 


- Insert/delete line 


If the termina! can open a new blank line before the line where the 
cursor is, the sequence should be given as al. Note that this is done 
only from the first position of a line. The cursor must then appear 

on the newly blank line. If the terminal can delete the line which 
the cursor is on, the sequence should be given as dl. This is done 
only from the first position on the line to be deleted. If the termi- 
nal can scroll the screen backwards, the sequence can be given as 
sb, but al can suffice. If the terminal can retain display memory 
above, the da capability should be given, and if display memory can 
be retained below, then db should be given. These let the editor 
know that deleting a line on the screen may bring non-blank lines 
up from below or that scrolling back with sb may bring down non- 
blank lines. 


Insert/delete character 


There are two basic kinds of intelligent terminals with respect to 
the insert/delete character which can be described using termcap. 
The most common insert/delete. character operations affect only 
the characters on.the current line and shift characters off the end 
of the line.. Other terminals, such as the Concept 100 and the Per- 
kin Elmer Owl, make, a distinction between typed and untyped 
blanks on the screen, shifting upon an insert or delete only to an 
untyped blank on the screen which is either eliminated, or 
expanded to two untyped blanks. You can find out which kind of 
terminal you have by clearing the screen and entering text separated 
by cursor motions. Enter ‘abc def’, using local cursor motions 
(not spaces) between the ‘abc’ and the ‘def’. Then position the 
cursor before the ‘abc’ and put the terminal in insert mode. If 
entering characters causes the rest of the line to shift mgidly and 
characters to fal! off the end, your terminal does not distinguish 
between blanks and untyped positions. If the ‘abc’ shifts over to the 
‘def? which then move together around the end of the current line 
and onto the next as you insert, you have the second type of termi- 
nal, and should give the capability in, which stands for ‘insert null’. 
No known terminals have an insert mode, not, falling into one of 
these two classes. le hops : 
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The editor can handle both terminals that have an insert mode and‘ 
terminals which send a simple’‘sequence to open a ‘blank position 
on the current line. Specify im as the sequence to get into insert 
mode, or give it an empty value if your terminal uses’ a sequence to 
insert a blank position. Specify ei as the sequence to leave insert 
mode (specify: ‘this with':an “empty value if: you also gave im an 
empty value). Now specify ici:as: any*sequence needed to be sent 
just before. sending the..chanacter.to be. inserted. :Most terminals 
with a true insert modewill: not:support ic, terminals which send a 
sequence to open ai screen »position: should ,give,.it here. (Insert 
mode is preferable to the sequence to open a position on the 
screen if your terminal has both.) If post insert padding is needed, 
give this as a number of milliseconds in ip (a string option). Any 
other sequence which may need to.be sent after an imsert of a single 
character may also be given im'ipe rr, tits 

: f ove 2 Coe te j : } ae 
It is occasionally necessary to‘move around while in:insert mode to 
delete characters on the same line (e.g.,.if there is a tab after the 
insertion position). If your terminal allows motion while in insert 
mode, you can give the capability mi to speed up inserting in this 
case. Omitting mi will affect only speed. Some terminals (notably 
Datamedia’s) must not have mi because of the way their insert 
mode works. 
Finally, “you can specify delete mode by giving dm and ed to enter 
and exit delete mode, and de to delete a single character while in 
delete mode. 


Highlighting, underlining, and visible bells 

ees jase flein: te ehaka ole 
If your. terminak has ..sequences,.to enterand exit standout mode, 
these‘can be given as so\land se:respectively. If there are several 
flavors of standout mode:<(such as reverse video, blinking, or under- 
lining — half bright is mot: usually an acceptable ‘standout’ mode 
unless the terminal is‘in'reverse:'video mode constantly), the pre- 
ferred mode is reverse vidéo by itself. It is acceptable, if the code 
to change into or out of stantout mode leaves one, or even two 
blank spaces on the screen, as the TVI 912 and Teleray 1061 do. 
Although it may confuse some programs slightly, it cannot be 
helped. 


Codes to ‘begin underlining and énd‘underlining:can,be given as us, 
and ue respectively. If the terminal has .a:code:to underline the 
current character and move the cursor one ‘space to the right, such 
as the Microterm Mime, the sequence. can be-given as uc. (If the 
utiderline code does not move the cursor .to ‘the right, specify the 


“iS code followed by a nondestructive space.); osir: bus 


ac " Po woe y Ge gi 

“If the terminal has. a way of flashing the screen,to,'indicate an error 
quietly (a bell replacement), the sequetce)can.be, given as vb; it 
must not move the cursor. If the terminal should be placed in a 
different mode during open and visual modes of ex, the sequence 


= . 
-— . 


August 26, 1985 He Oe Page 9 


ar 
thy casixt 


-TERMCAP (M) ! TERMCAP (M) 


can be given as vs and ve, sent at the start and end of these modes 
respectively. These can be used to change from a underline to a 


--\ block cursor and back. 


If the terminal needs to be in a special mode when running a pro- 
gram that; addresses the cursor, the codes to enter and exit this 


~» ‘mode can be given as fi and te. This arises, for example, from ter- 

-minals like the Concept with more than one page of memory. If 
'» the terminal: has only:memory relative cursor addressing and not 
0) 'gcreen relative cursor addressing, a one screen-sized window must 


+ ibe fixed into the terminal for cursor addressing to work properly. 


“Tf your terminal correctly generates underlined characters (with no 


special codes needed), even though it does not overstrike, you 


‘should give the capability ul. If overstrikes are erasable with a 
blank, this should be indicated by specifying eo. 


Keypad 


If the terminal has a keypad that transmits codes: when the keys are 
pressed, this information can be given. Note that it is not possible 
to handle terminals where the keypad only works in local (this 
applies, for example, to the unshifted HP 2621 keys). If the keypad 


can be set to transmit or not to transmit; enter these codes as ks 
and ke. Otherwise, the keypad is assumed ‘to always transmit. The 


- codes sent by the left arrow, right arrow; up arrow, down arrow, 
‘and home keys catbe given as.kl, kr,) ku, kd, and kh. If there are 
' function keys such ‘as ‘f0, f1, .:., £9; the codes. they send can be 


given as k0, ki; .4,-k9. If-these: keyschave labels other than the 
default f0 through £9, the labels can be given as 10, My sc. Ae 
there are other keys that transmit the same: code as the terminal 
expects for the corresponding function, such as clear screen, the 
termcap 2 letter codes can be given in the ko capability, for exam- 
ple, ‘-ko=cl,ll,sf,sb:’, which says that the terrninal has clear, home 
down, scroll down;‘ and scroll up keys ‘that transmit the same thing 
as the cl, ll, sf, and sb entries. Cee 


The ma entry is also used to indicate arrow keys on terminals which 
have single character arrow keys. It is obsolete, but still in use in 
version 2 of vi, which must be run on some minicomputers due to 
memory limitations. This field is redundant with kl, kr, ku, kd, and 
kh. It consists of groups of two characters. In each group, the 
first character is what an arrow key sends, the second character is 
the corresponding vi command. These commands are h for kl, j 
for kd, k for ku, 1 for kr, and H for kh. For ‘example, the Mime 


would ‘be :ma="Kj°Zk"Xi: indicating arrow keys left (H), down 
OK), up ((Z), and right (X). (There is no homé key on the Mime.) 
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Miscellaneous 


If the ieratnal’ requires other than ; a null (zero) character as a pad, 
this can be given as PF. 

ait hgio ft MY Se issih be Aes 
If tabs on ‘the ievninal require. padding, or if the terminal uses a 
character other than Tt to ie = sequence, can, be given as ta. 

‘ oo eee 

Terminals that ‘do not alionel fit M Hilkaktoen. to, be. Maplaved (such as 
Hazeltines), should. indi¢ate hz. _ Datamedia. terminals that echo 
carriage-return-linefeed ;for; carriage return, and,, then ignore a fol- 
lowing linefeed, should indicate ne. Early Concept terminals, that 
ignore a linefeed immediately after,an,am wrap, should indicate xn. 
If an erase-eol is required tg, get. rid. of standout, (instead of merely 
writing on top of it), xs should. be given. Teleray terminals, where 
tabs turn all characters moved over to blanks, should indicate xt. 
Other specific terminal problems may be corrected by adding more 
capabilities of the form xx. ie, 
If the leading character for commands to the terminal (normally the 
escape character) can be set by the software, specify the command 
character(s). with the capability CC. 


Other Sdenabilitise include is, an initialization string for the terminal, 


and. if, the; name_of a file containing long initialization strings. 
' These strings are expected, to properly clear and then set the tabs 


on the terminal, if.the terminal has settable tabs. If both are given, 
is is) «displayed. before jifj>, This, is. useful where if is 
/usrllib/tabset! std sibut i is clears the tabs.first. ,, 

a6 i Mee AS gin eeec) ere | At 


Similar Terminals... Gi ded Hee 


If iste are es ery ogi hate one. can be defined as being 
just like.the other with certain,exceptions. The string capability, te, 
can be.given- with the: name,of,.the similar terminal. This capability 
must be last and the ‘combined length of the two entries must not 
exceed 1024. Since termlib routines search the entry from left to 
right, and since the tc capability is replaced by the corresponding 
entry, the capabilities given at the left override the ones in the simi- 
lar terminal. A capability can. be cancelled with xx@ where xx is 


® sail itn For example: ....;. 


MGitsiass § MUI 


4a THON - ie yk : 
hn| 26240 ks@: ke@: tc=2621: tA i 


when i in visual mode. 
qr a terminal, or for different 


This defines: a 2621n1 that does not hays +: or ke capabilities, 


This is useful for different modes 
user preferences. 
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PERS a Sats pias Wf 
ENT): AOS. ,XENIX Extensions |, 

OSG) RSS; ud Bes 54 z Rie ie 

“a! Ot 4 ti, Capabilities ‘This table lists the (previously listed) XENIX extensions 
“ussst) sagst'¢ to the. termeap capabilities. It shows which codes generate informa- 
~toucusily inte ton input, from the Keyboard to the program reading the keyboard 
veale OF ~ 2 rats and, which; ¢odes, generate information output from the program to 
MES SF gy he the screen. . yi ae 


Name Input/Output Description 


CF _ str Cursor off 
Cl... str Sent by CHAR LEFT key 
CO - str Cursor on 
CW..str ... Sent by CHANGE WINDOW key 
DA ‘bool — Delete attribute string 
EN _ str Sent by END key 
G1 str Upper-right (1st quadrant) corner character 
G2 _ str Upper-left (2nd quadrant) corner character 
Patek. Se -G3_ str ,., , .,.. Lower-left (3rd quadrant) corner character 
: ‘G4 “str “°° °’''Lower=right (4th quadrant) corner character 
GC _ str Center graphics character (similar to +) 
GD _ str Down-tick character 
GE _ str Graphics mode end Se 
GG num Number of chars taken by GS and GE 
GH - str Horizontal bar chatactet | 
GL. . str Left-tick charactér’° 
GR _ str Right-tick character 
GS _ str Graphics mode start 
GU _ str Up-tick character 
vat ino. al GY str. ..,.,. Vertical bar character 
‘ou a iat ie HMO str,“ (60°) Sent by HOME key (if ot kh) 
og yMP str Multiplan initialization strihg | 
“MR str ———«~ Ss Muditiplan,reset: string’’*""’ ’"' ° 
NU str Sent by NEXT UNLOCKED CELL key 
PD str. _,___ Sent by PAGE DOWN key 
‘PU © str =>" “Sent by PAGE UP’ key” * 
wif DU shal! Jig RC «Str Po Sent by RECALC key 
RF _ str “Sent by TOGGLE REFERENCE key 
RT _ str Sent by RETURN key 
_UP - str Sent by up-arrow key (alternate to ku) 
WL - str Sent by WORD LEFT key 
WR str Sent by WORD RIGHT key 


Soh e™ ag ake ORES Sees, g we feu ed v7 } a 

i. Pea Ae Cursor, motion Some application programs make use of special edit- 
‘ing codes. CR and CL move the cursor one character night and left 
respectively. WR and WL move the cursor one word right and left 
respectively. CW changes windows, when they are used in the pro- 
gram. 


Some application programs turn off the cursor. This is accom-. 
plished using CF for cursor off and CO to turn it back on. 
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Graphic mode _ If the termina! has graphics capabilities, this mode 

can be turned on and off with the GS and GE codés. Some termi- 
nals generate graphics characters from all keys when in graphics 
mode (such‘as ‘the Visual 50). | ies other’G codes specify particular 
graphics chatacters accessed by’ escape sequences. These charac- 
ters are ‘available on some ‘ter dinals as’ alternate graphics character 
sets (not ‘as a bitmap graphic mode). ’The vt100 has access to this 


on kind of alternate graphics character set,~but ‘not to a bit-map 
graphic mode. : | 
QS be Fugue Niggas » aEyi 
At ete bt Ey 
| ie fis, Sd aide i 
/etc/termcap File containing terminal descriptidns 
ER Also | eae e an : 
Re ae Se \ te, 
; XQ), curse(S) erméap\S) heet(C), vi(C); more(C), console(M) 
Credit - | 
This “utility was developed at the University of California at 
Berkeley © and i is used with permission. 
SO? ete F402 Gia. 3 tt ‘ “4 
\— Notes The | a 
Aish .J 3 
Ex(C). ail Sty? 156 itiMcters for string capabilities, and the 
‘outings, in: ferméap(S)' dd’ ‘not check for ‘overflow of this buffer. 
The total: Jength, ofa single entry (excluding’ only escaped newlines) 
may, not i exceed 1024,’ ~ oe eee 
The 1 ma, vs, ‘and ve entries: are @ specific to the vi(C) program. 
Not all programs support ‘ait entries. There are entries that are not 
supported by. any program, ce : y 
XENIX termcap extensions are explained in detail in the software 
application peer a anon. | 
ce PRASH. lic SI oe 
a Refer to the console(M) manual page, for a description of the char- 
At 50%, 
hak. Clee sequences ‘used by the console device’ on‘your specific XENIX 
oD © ae : gn et > e a; if F 
i: ae System. btn ties 2 Rimi dcde ha 
ae $i, § a9¢; a REED. “OEE OD on ht . pk Vivid tod. 3 
PUPLIE® ESOS SHON TF ES. e- fes TEE Ws 2 a Ylaviougest 
a=, ‘ti if 
‘ter aiad al al Weiss et] Lo AM gong oousuiludE oace 
Wied dpe. «fF OD bic ast + MB EE tg, 
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